TheFork Restaurant
GET
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
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringFull TheFork restaurant page URL.
Example:
https://www.thefork.fr/restaurant/salamboo-amilkar-r10892#date=2026-06-13&rankedBy=SEARCH_ENGINENotes:
- 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.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
id?integerurl?stringname?stringslug?stringtags?array<>uuid?stringimage?stringimages?array<string>address?cuisine?stringratings?currency?stringavg_price?integerdescription?unknowngeolocation?is_bookable?booleanreviews_summary?stringopening_time_information?curl -X GET 'https://api.piloterr.com/v2/thefork/restaurant?query=string'Example Response
{ "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 } ] } }}