{"openapi":"3.1.0","info":{"title":"ittems API","description":"Product directory for AI agents. Search merchants' catalogs, read one product with specs, variants, price, availability and the merchant's shipping and returns terms. Every product links to the merchant's own buy page; ittems sells nothing.","version":"0.3.0"},"servers":[{"url":"https://ittems.com"}],"paths":{"/api/v1/search":{"get":{"tags":["catalog"],"summary":"Search products across merchants","operationId":"api_search_api_v1_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200,"description":"Free text, e.g. 'hammer black widow 15lb'. Empty = browse.","default":"","title":"Q"},"description":"Free text, e.g. 'hammer black widow 15lb'. Empty = browse."},{"name":"merchant","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[a-z0-9-]+$"},{"type":"null"}],"description":"Merchant slug, e.g. bowlersmart","title":"Merchant"},"description":"Merchant slug, e.g. bowlersmart"},{"name":"brand","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"Brand name, exact (case-insensitive)","title":"Brand"},"description":"Brand name, exact (case-insensitive)"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Category slug or name","title":"Category"},"description":"Category slug or name"},{"name":"in_stock","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true = only purchasable now (in stock or pre-order)","title":"In Stock"},"description":"true = only purchasable now (in stock or pre-order)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/merchants":{"get":{"tags":["catalog"],"summary":"List merchants with their policies","operationId":"api_merchants_api_v1_merchants_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/products/{merchant}/{slug}":{"get":{"tags":["catalog"],"summary":"One product with specs, variants, policies","operationId":"api_product_api_v1_products__merchant___slug__get","parameters":[{"name":"merchant","in":"path","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._-]+$","title":"Merchant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ucp/v1/catalog/search":{"post":{"tags":["ucp"],"summary":"UCP catalog search","operationId":"ucp_rest_search_ucp_v1_catalog_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UcpSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ucp/v1/catalog/lookup":{"post":{"tags":["ucp"],"summary":"UCP catalog lookup by ids","operationId":"ucp_rest_lookup_ucp_v1_catalog_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UcpLookupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ucp/v1/catalog/product":{"post":{"tags":["ucp"],"summary":"UCP product detail","operationId":"ucp_rest_product_ucp_v1_catalog_product_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UcpProductRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/ucp":{"get":{"tags":["ucp"],"summary":"UCP business profile","operationId":"ucp_profile__well_known_ucp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/{merchant}/feed/google.tsv":{"get":{"tags":["feeds"],"summary":"Google Merchant Center feed (TSV)","operationId":"feed_google__merchant__feed_google_tsv_get","parameters":[{"name":"merchant","in":"path","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._-]+$","title":"Merchant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{merchant}/feed/openai.jsonl":{"get":{"tags":["feeds"],"summary":"OpenAI product feed (JSONL)","operationId":"feed_openai__merchant__feed_openai_jsonl_get","parameters":[{"name":"merchant","in":"path","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._-]+$","title":"Merchant"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"UcpLookupRequest":{"properties":{"ids":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Ids"}},"additionalProperties":true,"type":"object","required":["ids"],"title":"UcpLookupRequest"},"UcpProductRequest":{"properties":{"id":{"type":"string","maxLength":200,"title":"Id"}},"additionalProperties":true,"type":"object","required":["id"],"title":"UcpProductRequest"},"UcpSearchRequest":{"properties":{"query":{"type":"string","maxLength":200,"title":"Query","default":""},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"pagination":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pagination"},"merchant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merchant","description":"ittems extension: limit to one merchant slug"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand","description":"ittems extension"},"in_stock":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Stock","description":"ittems extension"}},"additionalProperties":true,"type":"object","title":"UcpSearchRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}