# Social Fetch API - Tripadvisor endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 16 documented Tripadvisor operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/tripadvisor/search Search Tripadvisor places Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/search/get.mdx SDK: client.tripadvisor.search({ query: "eiffel tower", type: "attraction" }) Parameters: - query (required, string) - What to look for: a place, hotel, restaurant or attraction name, e.g. `eiffel tower` or `savoy london`. - type (optional, string, enum: geo | hotel | restaurant | attraction) - Only matches of this kind: `geo` (cities and regions), `hotel`, `restaurant` or `attraction`. Omit for every kind. curl "https://api.socialfetch.dev/v1/tripadvisor/search?query=eiffel%20tower" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/place Get Tripadvisor place by URL Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/place/get.mdx SDK: client.tripadvisor.getPlace({ url: "https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html" }) Parameters: - url (required, string) - A Tripadvisor hotel, restaurant or attraction page, e.g. `https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/place?url=https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/hotels List Tripadvisor hotels in a city Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/hotels/get.mdx SDK: client.tripadvisor.listHotels({ geoId: "186338" }) Parameters: - geoId (required, integer) - Tripadvisor geo id of a city or region, e.g. `60763` (New York City): the `g` number in a Tripadvisor address, or `locationId` of a `geo` search result. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/hotels?geoId=186338" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/restaurants List Tripadvisor restaurants in a city Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/restaurants/get.mdx SDK: client.tripadvisor.listRestaurants({ geoId: "60763" }) Parameters: - geoId (required, integer) - Tripadvisor geo id of a city or region, e.g. `60763` (New York City): the `g` number in a Tripadvisor address, or `locationId` of a `geo` search result. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/restaurants?geoId=60763" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/attractions List Tripadvisor attractions in a city Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/get.mdx SDK: client.tripadvisor.listAttractions({ geoId: "187147" }) Parameters: - geoId (required, integer) - Tripadvisor geo id of a city or region, e.g. `60763` (New York City): the `g` number in a Tripadvisor address, or `locationId` of a `geo` search result. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/attractions?geoId=187147" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/attractions/types List Tripadvisor attraction types in a city Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/types/get.mdx SDK: client.tripadvisor.listAttractionTypes({ geoId: "187147" }) Parameters: - geoId (required, integer) - Tripadvisor geo id of a city or region, e.g. `60763` (New York City): the `g` number in a Tripadvisor address, or `locationId` of a `geo` search result. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/attractions/types?geoId=187147" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/cruises Search Tripadvisor cruises Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/cruises/get.mdx SDK: client.tripadvisor.searchCruises({ geoId: "147237" }) Parameters: - geoId (required, integer) - Tripadvisor geo id of the cruise destination, e.g. `147237` (Caribbean) or `28923` (Alaska): the `g` number in a Tripadvisor address, or `locationId` of a `geo` search result. - departureMonth (optional, string) - Only cruises with a sailing that month, as `YYYY-MM`, e.g. `2027-01`. - cabinType (optional, string, enum: inside | oceanview | balcony | suite) - Only cruises offering this cabin: `inside`, `oceanview`, `balcony` or `suite`. - length (optional, string, enum: 1-2 | 3-5 | 6-9 | 10-14 | 15+ | weekend) - Only cruises of this length in days: `1-2`, `3-5`, `6-9`, `10-14`, `15+` or `weekend`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/cruises?geoId=147237" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/cruise-ships/{locationId} Get Tripadvisor cruise ship Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/cruise-ships/locationid/get.mdx SDK: client.tripadvisor.getCruiseShip({ locationId: "15691572" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/cruise-ships/15691572" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/cruise-ships/{locationId}/reviews List Tripadvisor cruise ship reviews Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/cruise-ships/locationid/reviews/get.mdx SDK: client.tripadvisor.listCruiseShipReviews({ locationId: "15691572" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/cruise-ships/15691572/reviews" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/hotels/{locationId} Get Tripadvisor hotel Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/hotels/locationid/get.mdx SDK: client.tripadvisor.getHotel({ locationId: "93450" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/hotels/93450" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/restaurants/{locationId} Get Tripadvisor restaurant Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/restaurants/locationid/get.mdx SDK: client.tripadvisor.getRestaurant({ locationId: "425570" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/restaurants/425570" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/attractions/{locationId} Get Tripadvisor attraction Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/locationid/get.mdx SDK: client.tripadvisor.getAttraction({ locationId: "188151" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/attractions/188151" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/places/{locationId}/reviews List reviews of a Tripadvisor place Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/places/locationid/reviews/get.mdx SDK: client.tripadvisor.listPlaceReviews({ locationId: "93450" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/places/93450/reviews" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/hotels/{locationId}/reviews List Tripadvisor hotel reviews Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/hotels/locationid/reviews/get.mdx SDK: client.tripadvisor.listHotelReviews({ locationId: "93450" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/hotels/93450/reviews" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/restaurants/{locationId}/reviews List Tripadvisor restaurant reviews Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/restaurants/locationid/reviews/get.mdx SDK: client.tripadvisor.listRestaurantReviews({ locationId: "425570" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/restaurants/425570/reviews" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/tripadvisor/attractions/{locationId}/reviews List Tripadvisor attraction reviews Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/locationid/reviews/get.mdx SDK: client.tripadvisor.listAttractionReviews({ locationId: "188151" }) Parameters: - locationId (required, integer) - Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/tripadvisor/attractions/188151/reviews" \ -H "x-api-key: YOUR_API_KEY"