{"openapi":"3.1.0","info":{"title":"Tripadvisor Content (BYOK) API","version":"0.1.0","description":"Tripadvisor Content (BYOK) lets an AI assistant read your own Tripadvisor Content data through the Tripadvisor Content API with a key you supply (Tripadvisor Content API key). Read-only: 5 tools (search_locations, nearby_search_locations, get_location_details, list_location_reviews, list_location_photos). The BYOK key travels with each request, is used for that one call only and is never stored,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-tripadvisor.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-tripadvisor/docs"},"termsOfService":"https://connectorbay.com/byok-tripadvisor/terms"},"servers":[{"url":"https://byok-tripadvisor.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-tripadvisor/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_locations":{"post":{"operationId":"search_locations","summary":"Search Tripadvisor locations by name (up to 10 results), optionally narrowed by category, phone, address or coordinates.","description":"Search Tripadvisor locations by name (up to 10 results), optionally narrowed by category, phone, address or coordinates. Use for \"Find the Tripadvisor listing for Hotel Taj Mahal Palace in Mumbai\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search_query":{"description":"Text to search, matched against location names, for example 'Taj Mahal Palace Mumbai'.","maxLength":200,"title":"Search Query","type":"string"},"category":{"anyOf":[{"enum":["hotels","attractions","restaurants","geos"],"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to one kind of place: hotels, attractions, restaurants or geos.","title":"Category"},"phone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Phone number filter, digits and separators without the leading +.","title":"Phone"},"address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Address text to narrow results.","title":"Address"},"lat_long":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Coordinates 'lat,long' to scope the search, for example '18.9217,72.8332'.","title":"Lat Long"},"radius":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Radius around lat_long (number as text); use with radius_unit.","title":"Radius"},"radius_unit":{"anyOf":[{"enum":["km","mi","m"],"type":"string"},{"type":"null"}],"default":null,"description":"Unit of radius: km, mi or m.","title":"Radius Unit"},"language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"en","description":"Language code of the answer, for example en, es, pt, ja, ko, th, vi, ar (default en).","title":"Language"}},"required":["search_query"],"title":"search_locationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/nearby_search_locations":{"post":{"operationId":"nearby_search_locations","summary":"Find up to 10 Tripadvisor places near a latitude/longitude pair, optionally of one category. Use for \"Which restaurants ","description":"Find up to 10 Tripadvisor places near a latitude/longitude pair, optionally of one category. Use for \"Which restaurants on Tripadvisor are near 13.7563,100.5018 in Bangkok\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"lat_long":{"description":"Coordinates as 'lat,long', for example '13.7563,100.5018'.","maxLength":200,"title":"Lat Long","type":"string"},"category":{"anyOf":[{"enum":["hotels","attractions","restaurants","geos"],"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to one kind of place: hotels, attractions, restaurants or geos.","title":"Category"},"phone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Phone number filter, digits and separators without the leading +.","title":"Phone"},"address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Address text to narrow results.","title":"Address"},"radius":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Radius around the point (number as text); use with radius_unit.","title":"Radius"},"radius_unit":{"anyOf":[{"enum":["km","mi","m"],"type":"string"},{"type":"null"}],"default":null,"description":"Unit of radius: km, mi or m.","title":"Radius Unit"},"language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"en","description":"Language code of the answer, for example en, es, pt, ja, ko, th, vi, ar (default en).","title":"Language"}},"required":["lat_long"],"title":"nearby_search_locationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_location_details":{"post":{"operationId":"get_location_details","summary":"Get a Tripadvisor listing: name, address, coordinates, rating, review count, price level, ranking, category and amenitie","description":"Get a Tripadvisor listing: name, address, coordinates, rating, review count, price level, ranking, category and amenities. Use for \"What is the rating and ranking of Tripadvisor location 60745\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location_id":{"description":"Tripadvisor location id (integer), taken from search_locations or nearby_search_locations.","title":"Location Id","type":"integer"},"language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"en","description":"Language code of the answer, for example en, es, pt, ja, ko, th, vi, ar (default en).","title":"Language"},"currency":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":"USD","description":"ISO 4217 currency code for prices (default USD).","title":"Currency"}},"required":["location_id"],"title":"get_location_detailsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_location_reviews":{"post":{"operationId":"list_location_reviews","summary":"List recent Tripadvisor reviews of a location: rating, title, text, trip type, travel and publish dates and owner respon","description":"List recent Tripadvisor reviews of a location: rating, title, text, trip type, travel and publish dates and owner response. Use for \"What do recent Tripadvisor reviews say about location 60745\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location_id":{"description":"Tripadvisor location id (integer), taken from search_locations or nearby_search_locations.","title":"Location Id","type":"integer"},"language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"en","description":"Language code of the answer, for example en, es, pt, ja, ko, th, vi, ar (default en).","title":"Language"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result, for paging.","title":"Offset"}},"required":["location_id"],"title":"list_location_reviewsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_location_photos":{"post":{"operationId":"list_location_photos","summary":"List Tripadvisor photos of a location with caption, album, source type and image URLs. Use for \"Show Tripadvisor photos ","description":"List Tripadvisor photos of a location with caption, album, source type and image URLs. Use for \"Show Tripadvisor photos of location 60745\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"location_id":{"description":"Tripadvisor location id (integer), taken from search_locations or nearby_search_locations.","title":"Location Id","type":"integer"},"language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"en","description":"Language code of the answer, for example en, es, pt, ja, ko, th, vi, ar (default en).","title":"Language"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result, for paging.","title":"Offset"},"source":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated photo sources to allow, for example Expert,Management,Traveler.","title":"Source"}},"required":["location_id"],"title":"list_location_photosArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}