Piloterr

TheFork Restaurant

Extract a full TheFork restaurant profile from a restaurant page URL, including ratings, tags, photo gallery, opening hours, and AI review summaries via browser rendering.

Credit cost: 2 credits per call

GET
/v2/thefork/restaurant

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full TheFork restaurant page URL.

Example:

https://www.thefork.fr/restaurant/salamboo-amilkar-r10892#date=2026-06-13&rankedBy=SEARCH_ENGINE

Notes:

  • Only /restaurant/{slug}-r{id} URLs on TheFork domains are accepted.
  • Hash parameters (#date=...) are optional and preserved when relevant.
  • Restaurant pages are JavaScript SPAs; this endpoint uses website rendering to extract ratings, tags, photos, hours, and AI review summaries.
  • Copy the restaurant URL from search results or from thefork.fr.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/thefork/restaurant?query=string"
{
  "id": 668497,
  "url": "https://www.thefork.fr/restaurant/le-petit-casa-r668497",
  "name": "Le Petit Casa",
  "slug": "le-petit-casa",
  "tags": [
    {
      "id": "1829",
      "name": "Bas-Rhin (67)",
      "category": {
        "id": "21"
      },
      "is_published": true
    },
    {
      "id": "5779",
      "name": "Carte Cadeau",
      "category": {
        "id": "11"
      },
      "is_published": true
    },
    {
      "id": "5777",
      "name": "Déjeuner",
      "category": {
        "id": "11"
      },
      "is_published": true
    },
    {
      "id": "1",
      "name": "En famille",
      "category": {
        "id": "11"
      },
      "is_published": true
    },
    {
      "id": "1460",
      "name": "Enfants bienvenus !",
      "category": {
        "id": "11"
      },
      "is_published": true
    },
    {
      "id": "2",
      "name": "Entre amis",
      "category": {
        "id": "11"
      },
      "is_published": true
    },
    {
      "id": "381",
      "name": "Traditionnel",
      "category": {
        "id": "11"
      },
      "is_published": true
    },
    {
      "id": "644",
      "name": "Trip Advisor",
      "category": {
        "id": "14"
      },
      "is_published": true
    },
    {
      "id": "335",
      "name": "Halal",
      "category": {
        "id": "8"
      },
      "is_published": true
    },
    {
      "id": "470",
      "name": "Options végétariennes",
      "category": {
        "id": "8"
      },
      "is_published": true
    },
    {
      "id": "2372",
      "name": "Petit Prix",
      "category": {
        "id": "9"
      },
      "is_published": true
    },
    {
      "id": "312",
      "name": "Carte Bleue",
      "category": {
        "id": "5"
      },
      "is_published": true
    },
    {
      "id": "314",
      "name": "Carte Mastercard",
      "category": {
        "id": "5"
      },
      "is_published": true
    },
    {
      "id": "315",
      "name": "Carte Visa",
      "category": {
        "id": "5"
      },
      "is_published": true
    },
    {
      "id": "4367",
      "name": "TheFork PAY",
      "category": {
        "id": "5"
      },
      "is_published": true
    },
    {
      "id": "317",
      "name": "Titres et chèques pour les restaurants",
      "category": {
        "id": "5"
      },
      "is_published": true
    },
    {
      "id": "2699",
      "name": "UnionPay",
      "category": {
        "id": "5"
      },
      "is_published": true
    },
    {
      "id": "660",
      "name": "Couscous",
      "category": {
        "id": "6"
      },
      "is_published": true
    },
    {
      "id": "513",
      "name": "Viande et grillades",
      "category": {
        "id": "6"
      },
      "is_published": true
    },
    {
      "id": "1109",
      "name": "Place de Haguenau",
      "category": {
        "id": "4"
      },
      "is_published": true
    },
    {
      "id": "1742",
      "name": "Alsace",
      "category": {
        "id": "20"
      },
      "is_published": true
    },
    {
      "id": "5859",
      "name": "France",
      "category": {
        "id": "20"
      },
      "is_published": true
    },
    {
      "id": "3461",
      "name": "Grand Est",
      "category": {
        "id": "20"
      },
      "is_published": true
    },
    {
      "id": "346",
      "name": "Accès personnes à mobilité réduite",
      "category": {
        "id": "10"
      },
      "is_published": true
    },
    {
      "id": "359",
      "name": "Anglais parlé",
      "category": {
        "id": "10"
      },
      "is_published": true
    },
    {
      "id": "360",
      "name": "Français parlé",
      "category": {
        "id": "10"
      },
      "is_published": true
    },
    {
      "id": "466",
      "name": "Marocain",
      "category": {
        "id": "12"
      },
      "is_published": true
    },
    {
      "id": "460",
      "name": "Oriental",
      "category": {
        "id": "12"
      },
      "is_published": true
    }
  ],
  "uuid": "265f611d-cb85-4ae4-a779-e963df820a4b",
  "image": "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/b9c443c8-06c8-4d56-8e87-419c66f7eeee.jpg",
  "images": [
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/b9c443c8-06c8-4d56-8e87-419c66f7eeee.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/e69b12cc-a28a-4d17-b6ff-1a32c51c94ce.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/fe8d67df-8d21-481d-ac76-87111a1c3f2f.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/5ec87fc3-01ef-4021-8cfd-97a35f14e5d7.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/e370aa25-b074-41b8-a8e7-1f643f85af64.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/635a90be-2eb1-4592-8841-75f839ed8d8b.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/9ae02f81-bc2a-42e7-a3b1-a64714e42771.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/30c1c7f4-b466-4728-b777-6f59c8edc606.jpg",
    "https://cdn.thefork.com/tf-lab/image/upload/restaurant/265f611d-cb85-4ae4-a779-e963df820a4b/ff8bfd1f-a0f2-40c1-a623-61f13b28399a.jpg"
  ],
  "address": {
    "street": "24 Rue Thiergarten",
    "country": "France",
    "locality": "Strasbourg",
    "zip_code": "67000"
  },
  "cuisine": "Marocain",
  "ratings": {
    "thefork": {
      "rating": 9.8,
      "reviews_count": 1030
    },
    "tripadvisor": {
      "rating": 4.8,
      "reviews_count": 53
    }
  },
  "currency": "EUR",
  "avg_price": 35,
  "description": null,
  "geolocation": {
    "latitude": 48.5853087,
    "longitude": 7.7378558
  },
  "is_bookable": true,
  "reviews_summary": "Le Petit Casa enchante par son ambiance chaleureuse et dépaysante, évoquant un véritable voyage au Maroc. Les clients apprécient les plats marocains raffinés, notamment le couscous aux saveurs équilibrées et les tajines exquis. Le service est irréprochable, avec un accueil chaleureux et des conseils avisés. Une expérience inoubliable à découvrir sans hésitation, avec un excellent rapport qualité-prix.",
  "opening_time_information": {
    "opening_hours": {
      "fri": [
        {
          "end": 870,
          "start": 720
        },
        {
          "end": 1350,
          "start": 1140
        }
      ],
      "mon": [
        {
          "end": 870,
          "start": 720
        },
        {
          "end": 1350,
          "start": 1140
        }
      ],
      "sat": [
        {
          "end": 870,
          "start": 720
        },
        {
          "end": 1350,
          "start": 1140
        }
      ],
      "sun": [],
      "thu": [
        {
          "end": 870,
          "start": 720
        },
        {
          "end": 1350,
          "start": 1140
        }
      ],
      "tue": [
        {
          "end": 870,
          "start": 720
        },
        {
          "end": 1350,
          "start": 1140
        }
      ],
      "wed": [
        {
          "end": 870,
          "start": 720
        },
        {
          "end": 1350,
          "start": 1140
        }
      ]
    }
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}