{"slug":"agent-api-production-tim1712-workers-dev-v1-shopping-product-10db5a","title":"Use when an agent already knows the product it wants and needs real current Shop","host":"agent-api-production.tim1712.workers.dev","method":"POST","resource":"https://agent-api-production.tim1712.workers.dev/v1/shopping/product-search","category":"commerce","description":"Use when an agent already knows the product it wants and needs real current Shopify listings for a structured query. Returns normalized product/variant price, currency, seller, rating, product URL and checkout URL in upstream search-rank order, with an optional maximum item price. The query must alr","price_listed":0.01,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"country":"NL","currency":"EUR","limit":5,"maxPriceMinor":15000,"query":"65W USB-C power bank 20000mAh airline safe"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"country":{"pattern":"^[A-Z]{2}$","type":"string"},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"limit":{"maximum":10,"minimum":1,"type":"integer"},"maxPriceMinor":{"minimum":0,"type":"integer"},"query":{"maxLength":256,"minLength":1,"type":"string"}},"required":["country","currency","query"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"checkedAt":{"type":"string"},"country":{"pattern":"^[A-Z]{2}$","type":"string"},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"maxPriceMinor":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"products":{"items":{"additionalProperties":false,"properties":{"checkoutUrl":{"type":"string"},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"priceMinor":{"minimum":0,"type":"integer"},"productId":{"type":"string"},"productTitle":{"type":"string"},"productUrl":{"type":"string"},"rating":{"anyOf":[{"additionalProperties":false,"properties":{"count":{"minimum":0,"type":"integer"},"value":{"type":"number"}},"required":["value","count"],"type":"object"},{"type":"null"}]},"searchRank":{"minimum":0,"type":"integer"},"seller":{"anyOf":[{"additionalProperties":false,"properties":{"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","domain","url"],"type":"object"},{"type":"null"}]},"variantId":{"type":"string"},"variantTitle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["productId","variantId","productTitle","variantTitle","priceMinor","currency","productUrl","checkoutUrl","seller","rating","searchRank"],"type":"object"},"type":"array"},"query":{"type":"string"},"source":{"const":"shopify-global-catalog","type":"string"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["source","country","currency","query","maxPriceMinor","products","warnings","checkedAt"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Use when an agent already knows the product it wants and needs real current Shopify listings for a structured query. Returns normalized product/variant price, currency, seller, rating, product URL and checkout URL in upstream search-rank order, with an optional maximum item price. The query must already carry the compatibility and preference details. Not a recommendation engine, intent interpretation, web search, or cart/checkout.","last_updated":"2026-09-14T18:43:59.147Z","schemes":["exact"]}