{"openapi":"3.1.0","info":{"title":"Get Your Guide (BYOK) API","version":"0.1.0","description":"Get Your Guide (BYOK) lets an AI assistant read your own Get Your Guide data through the Get Your Guide API with a key you supply (GetYourGuide Partner API access token). Read-only: 9 tools (search_tours, get_tour, list_tour_options, get_option, get_tour_availability, list_categories, get_category, list_tour_reviews, get_supplier). The BYOK key travels with each request, is used for that one call...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-getyourguide.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-getyourguide/docs"},"termsOfService":"https://connectorbay.com/byok-getyourguide/terms"},"servers":[{"url":"https://byok-getyourguide.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-getyourguide/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_tours":{"post":{"operationId":"search_tours","summary":"Search GetYourGuide tours and activities by place name or IATA code (iata:jfk) with rating, price, categories and URL. U","description":"Search GetYourGuide tours and activities by place name or IATA code (iata:jfk) with rating, price, categories and URL. Up to 500 per page. Use for \"Which tours can I book in Bangkok on GetYourGuide\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Place name or IATA airport code ('iata:bkk'); at most 150 characters.","maxLength":150,"title":"Q","type":"string"},"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"},"preformatted":{"anyOf":[{"enum":["teaser","home","full"],"type":"string"},{"type":"null"}],"default":"teaser","description":"How much text to include per tour: teaser (title and abstract), home or full.","title":"Preformatted"},"sortfield":{"anyOf":[{"enum":["popularity","price","rating","duration"],"type":"string"},{"type":"null"}],"default":null,"description":"Order: popularity (recommended), price, rating or duration.","title":"Sortfield"},"sortdirection":{"anyOf":[{"enum":["ASC","DESC"],"type":"string"},{"type":"null"}],"default":null,"description":"ASC or DESC (ignored for popularity).","title":"Sortdirection"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of items to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of items to skip, for paging.","title":"Offset"}},"required":["q","cnt_language","currency"],"title":"search_toursArguments","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_tour":{"post":{"operationId":"get_tour","summary":"Get one GetYourGuide tour: title, description, rating, highlights, inclusions, price, locations, cancellation policy and","description":"Get one GetYourGuide tour: title, description, rating, highlights, inclusions, price, locations, cancellation policy and URL. Use for \"Give me the details of GetYourGuide tour 50872\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tour_id":{"description":"GetYourGuide tour id (integer) from search_tours.","title":"Tour Id","type":"integer"},"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"},"preformatted":{"anyOf":[{"enum":["teaser","home","full"],"type":"string"},{"type":"null"}],"default":null,"description":"How much text to include: teaser, home or full.","title":"Preformatted"}},"required":["tour_id","cnt_language","currency"],"title":"get_tourArguments","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_tour_options":{"post":{"operationId":"list_tour_options","summary":"List the bookable options of a tour (variants) with title, meeting point, duration, languages and booking questions. Use","description":"List the bookable options of a tour (variants) with title, meeting point, duration, languages and booking questions. Use for \"What options does GetYourGuide tour 50872 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tour_id":{"description":"GetYourGuide tour id (integer) from search_tours.","title":"Tour Id","type":"integer"},"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of items to return (1 to 100).","title":"Limit"}},"required":["tour_id","cnt_language","currency"],"title":"list_tour_optionsArguments","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_option":{"post":{"operationId":"get_option","summary":"Get one tour option by id with meeting point, duration, validity, languages and booking questions. Use for \"Show GetYour","description":"Get one tour option by id with meeting point, duration, validity, languages and booking questions. Use for \"Show GetYourGuide option 69232\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"option_id":{"description":"Tour option id from list_tour_options.","title":"Option Id","type":"integer"},"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"}},"required":["option_id","cnt_language","currency"],"title":"get_optionArguments","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_tour_availability":{"post":{"operationId":"get_tour_availability","summary":"Get the availability of a tour: participant range, participant categories, add-ons and the dates that can be booked. Use","description":"Get the availability of a tour: participant range, participant categories, add-ons and the dates that can be booked. Use for \"Which dates are open for GetYourGuide tour 50872\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tour_id":{"description":"GetYourGuide tour id (integer) from search_tours.","title":"Tour Id","type":"integer"},"cnt_language":{"description":"Language of text content (ISO 639), default en.","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"}},"required":["tour_id","cnt_language"],"title":"get_tour_availabilityArguments","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_categories":{"post":{"operationId":"list_categories","summary":"List GetYourGuide tour categories with id and name (use the ids as category filters elsewhere). Use for \"What tour categ","description":"List GetYourGuide tour categories with id and name (use the ids as category filters elsewhere). Use for \"What tour categories does GetYourGuide have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Number of items to return (1 to 500).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of items to skip, for paging.","title":"Offset"}},"required":["cnt_language","currency"],"title":"list_categoriesArguments","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_category":{"post":{"operationId":"get_category","summary":"Get one tour category by id. Use for \"What is GetYourGuide category 33\".","description":"Get one tour category by id. Use for \"What is GetYourGuide category 33\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category_id":{"description":"Category id from list_categories.","title":"Category Id","type":"integer"},"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"}},"required":["category_id","cnt_language","currency"],"title":"get_categoryArguments","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_tour_reviews":{"post":{"operationId":"list_tour_reviews","summary":"Get the rating breakdown and customer reviews of a tour (rating, subject, comment, date, reviewer first name and country","description":"Get the rating breakdown and customer reviews of a tour (rating, subject, comment, date, reviewer first name and country). Use for \"What do travellers say about GetYourGuide tour 50872\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tour_id":{"description":"GetYourGuide tour id (integer) from search_tours.","title":"Tour Id","type":"integer"},"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"},"sortfield":{"anyOf":[{"enum":["rating","date"],"type":"string"},{"type":"null"}],"default":null,"description":"Order: rating or date.","title":"Sortfield"},"sortdirection":{"anyOf":[{"enum":["ASC","DESC"],"type":"string"},{"type":"null"}],"default":null,"description":"ASC or DESC.","title":"Sortdirection"},"date":{"anyOf":[{"maxLength":19,"type":"string"},{"type":"null"}],"default":null,"description":"Only reviews newer than this local date-time, for example 2026-01-01T00:00:00.","title":"Date"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of items to return (1 to 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":300,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Reviews to skip (at most 300).","title":"Offset"}},"required":["tour_id","cnt_language","currency"],"title":"list_tour_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/get_supplier":{"post":{"operationId":"get_supplier","summary":"Get a tour supplier's profile: name, description, rating, number of reviews, categories and address. Use for \"Who is Get","description":"Get a tour supplier's profile: name, description, rating, number of reviews, categories and address. Use for \"Who is GetYourGuide supplier 26045 and how are they rated\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"supplier_id":{"description":"Supplier id from a tour's supplier_id field.","title":"Supplier Id","type":"integer"},"cnt_language":{"description":"Language of text content, an ISO 639 code such as en, es, ja, th or zh (default en).","enum":["ar","bg","ca","cs","da","de","el","en","es","et","fi","fr","he","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","zh","zh-hant"],"title":"Cnt Language","type":"string"},"currency":{"description":"ISO 4217 currency for prices, for example USD, EUR, INR, AED, SGD (default USD).","enum":["AED","ARS","AUD","BGN","CAD","CHF","CLP","CNY","COP","CZK","DKK","EGP","EUR","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MAD","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","UAH","USD","UYU","VND","ZAR"],"title":"Currency","type":"string"}},"required":["supplier_id","cnt_language","currency"],"title":"get_supplierArguments","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}}}}