{"openapi":"3.1.0","info":{"title":"Barcode Lookup (BYOK) API","version":"0.1.0","description":"Barcode Lookup (BYOK) lets an AI assistant read your own Barcode Lookup data through the Barcode Lookup API with a key you supply (Barcode Lookup API key). Read-only: 8 tools (lookup_by_barcode, lookup_by_asin, lookup_by_mpn, search_products_by_title, search_products, search_products_by_brand, search_products_by_manufacturer, search_products_by_category). The BYOK key travels with each request,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-barcodelookup.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-barcodelookup/docs"},"termsOfService":"https://connectorbay.com/byok-barcodelookup/terms"},"servers":[{"url":"https://byok-barcodelookup.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-barcodelookup/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/lookup_by_barcode":{"post":{"operationId":"lookup_by_barcode","summary":"Look up one product by UPC, EAN or ISBN barcode: title, brand, manufacturer, category, description, images, attributes a","description":"Look up one product by UPC, EAN or ISBN barcode: title, brand, manufacturer, category, description, images, attributes and store prices as sent by Barcode Lookup. Counts as one call of the plan. Use for \"What product has barcode 885909950805\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"barcode":{"description":"UPC, EAN or ISBN barcode digits.","maxLength":200,"title":"Barcode","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"}},"required":["barcode"],"title":"lookup_by_barcodeArguments","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/lookup_by_asin":{"post":{"operationId":"lookup_by_asin","summary":"Look up a product by Amazon ASIN. Counts as one call of the plan. Use for \"What product has Amazon ASIN B00E4FU1LK\".","description":"Look up a product by Amazon ASIN. Counts as one call of the plan. Use for \"What product has Amazon ASIN B00E4FU1LK\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"asin":{"description":"Amazon ASIN, ten characters.","maxLength":200,"title":"Asin","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"}},"required":["asin"],"title":"lookup_by_asinArguments","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/lookup_by_mpn":{"post":{"operationId":"lookup_by_mpn","summary":"Look up products by manufacturer part number. Counts as one call of the plan. Use for \"Which product has manufacturer pa","description":"Look up products by manufacturer part number. Counts as one call of the plan. Use for \"Which product has manufacturer part number MQ022LL/A\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"mpn":{"description":"Manufacturer part number.","maxLength":200,"title":"Mpn","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"},"page":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number for term-based searches (10 products per page).","title":"Page"}},"required":["mpn"],"title":"lookup_by_mpnArguments","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/search_products_by_title":{"post":{"operationId":"search_products_by_title","summary":"Search products by title words; returns up to 10 per page. Counts as one call of the plan. Use for \"Find products titled","description":"Search products by title words; returns up to 10 per page. Counts as one call of the plan. Use for \"Find products titled Nikon D850\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"title":{"description":"Words from the product title.","maxLength":200,"title":"Title","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"},"page":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number for term-based searches (10 products per page).","title":"Page"}},"required":["title"],"title":"search_products_by_titleArguments","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/search_products":{"post":{"operationId":"search_products","summary":"Search products across all text terms (title, brand, manufacturer, category) at once; up to 10 per page. Counts as one c","description":"Search products across all text terms (title, brand, manufacturer, category) at once; up to 10 per page. Counts as one call of the plan. Use for \"Search for stainless steel water bottles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"description":"Search words.","maxLength":200,"title":"Search","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"},"page":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number for term-based searches (10 products per page).","title":"Page"}},"required":["search"],"title":"search_productsArguments","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/search_products_by_brand":{"post":{"operationId":"search_products_by_brand","summary":"List products of a brand, up to 10 per page. Counts as one call of the plan. Use for \"Which products does the brand Bose","description":"List products of a brand, up to 10 per page. Counts as one call of the plan. Use for \"Which products does the brand Bose make\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"brand":{"description":"Brand name.","maxLength":200,"title":"Brand","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"},"page":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number for term-based searches (10 products per page).","title":"Page"}},"required":["brand"],"title":"search_products_by_brandArguments","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/search_products_by_manufacturer":{"post":{"operationId":"search_products_by_manufacturer","summary":"List products of a manufacturer, up to 10 per page. Counts as one call of the plan. Use for \"Which products does the man","description":"List products of a manufacturer, up to 10 per page. Counts as one call of the plan. Use for \"Which products does the manufacturer Philips make\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"manufacturer":{"description":"Manufacturer name.","maxLength":200,"title":"Manufacturer","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"},"page":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number for term-based searches (10 products per page).","title":"Page"}},"required":["manufacturer"],"title":"search_products_by_manufacturerArguments","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/search_products_by_category":{"post":{"operationId":"search_products_by_category","summary":"List products in a category based on Google's product taxonomy, up to 10 per page. Counts as one call of the plan. Use f","description":"List products in a category based on Google's product taxonomy, up to 10 per page. Counts as one call of the plan. Use for \"Show products in the category Electronics > Audio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Category name or path from Google's product taxonomy.","maxLength":200,"title":"Category","type":"string"},"formatted":{"anyOf":[{"const":"y","type":"string"},{"type":"null"}],"default":null,"description":"Send 'y' for the vendor's easier-to-read result format.","title":"Formatted"},"geo":{"anyOf":[{"enum":["US","CA","GB","EU"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit store data to a region: US, CA, GB or EU.","title":"Geo"},"page":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number for term-based searches (10 products per page).","title":"Page"}},"required":["category"],"title":"search_products_by_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}}}}