> ## Documentation Index > Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search Products > Search retailer catalogs for products, prices, and offer data via the Zinc API. ## OpenAPI ````yaml versions/latest.json GET /products/search openapi: 3.1.0 info: title: Zinc summary: >- Zinc lets you search, buy, and return items from top online retailers with a single API. description: >- Search, buy, and return items from top online retailers with a single API. Supports AI agent ordering via MPP (HTTP 402) — no account required. Supported retailers include 1-800-Flowers, Ace Hardware, Amazon, Amazon DE, Barnes & Noble, Best Buy, Chewy, Gap, IBS, Lowe's, Macys, Partstown, and 11 more. Ships to the US and 2 other countries (DE, IT). version: '2026-08-21' x-logo: url: https://mintlify.s3.us-west-1.amazonaws.com/zinc/logo/light.png contact: name: Zinc API Support email: support@zinc.com url: https://zinc.com/docs x-guidance: >- Zinc lets AI agents buy products from online retailers via a single API. Use POST /agent/orders to place an order — no Zinc account needed, payment is handled via MPP (HTTP 402 flow). Provide a product URL from a supported retailer, a shipping address, and max_price in cents. The API charges max_price + $1 API fee upfront and refunds the difference on completion. To find products first, the /agent/* data endpoints (search, products/search, products/offers, products/details) are MPP-paid at $0.01 per call; /agent/search returns orderable URLs to feed straight into /agent/orders. GET /retailers lists supported retailers for free (no payment or account). Authenticated equivalents (orders, products, managed-accounts) require a Bearer token (API key prefixed zn_). Docs: https://zinc.com/docs Supported retailers include 1-800-Flowers, Ace Hardware, Amazon, Amazon DE, Barnes & Noble, Best Buy, Chewy, Gap, IBS, Lowe's, Macys, Partstown, and 11 more, shipping to the US and 2 other countries (DE, IT). x-supported-retailers: - 1-800-Flowers - Ace Hardware - Amazon - Amazon DE - Barnes & Noble - Best Buy - Chewy - Gap - IBS - Lowe's - Macys - Partstown - Pokémon Center - Sephora - Target - The Home Depot - TikTok - Walmart - Wayfair - Zinc - eBay - libraccio - zazzle x-supported-countries: - US - DE - IT servers: - url: https://api.zinc.com description: Production security: - BearerAuth: [] paths: /products/search: get: tags: - products summary: Search Products description: >- Search for products on a retailer. **Best Buy returns a partial page.** Best Buy server-renders only about 4 of the ~24 products on a search page and loads the rest in the browser, so each page yields roughly 4 results rather than a full page. Ranking, pricing and availability are Best Buy's own; there are simply fewer items per page. Page through with `next_page` to collect more — `next_page` reflects whether Best Buy has further results, not how many came back in this response. **Shopify stores are their own retailer**: pass the store's domain as `retailer` (e.g. `retailer=yetch.studio`; any Shopify-powered storefront works). Results are the store's own top matches (~10) and there is no pagination, so `next_page` is always null and `page` must be omitted or 1. `product_id` is the store-scoped product handle to pass to the details endpoint with the same `retailer`. **Etsy search covers US shops, priced in USD.** Etsy sellers price in their own currency and a single page routinely mixes several, which makes `price` incomparable across a result set — so search is narrowed to US-located shops and any remaining non-USD listing is dropped. `currency_code` is set on every result and is always `USD` here, and prices are never converted, so the number is what the seller charges. Because the currency check runs after Etsy paginates, **a page can come back short while more results still exist** — page on with `next_page`. (Details is neither narrowed nor filtered: it returns any listing, in its own currency.) Etsy results carry no `stars`/`num_reviews` — Etsy publishes a rating for the *shop*, not the listing, and reporting a seller's rating as the product's would be misleading; `brand` carries the shop name, and the details endpoint reports the shop's rating explicitly. `product_id` is the numeric listing id. operationId: search_products_products_search_get parameters: - name: query in: query required: true schema: type: string minLength: 1 description: Search term title: Query description: Search term - name: retailer in: query required: true schema: type: string description: >- Retailer identifier: amazon, walmart, bestbuy, etsy, or a Shopify store's domain (e.g. retailer=yetch.studio) title: Retailer description: >- Retailer identifier: amazon, walmart, bestbuy, etsy, or a Shopify store's domain (e.g. retailer=yetch.studio) - name: page in: query required: false schema: anyOf: - type: integer - type: 'null' description: Page number for pagination title: Page description: Page number for pagination - name: free_shipping in: query required: false schema: type: boolean description: >- Only return items that ship for free (Walmart and Best Buy: ship price of 0). Currently a no-op for Amazon: the upstream search data under-reports Prime, so filtering on it would drop valid items — Amazon results are returned unfiltered. Filtering happens after pagination, so per-page counts vary; use `next_page` in the response to keep paging — an empty page with a non-null `next_page` is not the end of results. Rejected for Shopify stores: their search data carries no shipping information, so the filter cannot be honored. default: false title: Free Shipping description: >- Only return items that ship for free (Walmart and Best Buy: ship price of 0). Currently a no-op for Amazon: the upstream search data under-reports Prime, so filtering on it would drop valid items — Amazon results are returned unfiltered. Filtering happens after pagination, so per-page counts vary; use `next_page` in the response to keep paging — an empty page with a non-null `next_page` is not the end of results. Rejected for Shopify stores: their search data carries no shipping information, so the filter cannot be honored. - name: authorization in: header required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ProductSearchResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ProductSearchResponse: properties: status: type: string title: Status results: items: $ref: '#/components/schemas/ProductSearchResult' type: array title: Results default: [] next_page: anyOf: - type: integer - type: 'null' title: Next Page description: >- Only set on free_shipping searches: the page to request to keep paging. An empty `results` with a non-null next_page is NOT the end of results — request next_page to continue. None means results are exhausted (or the search was unfiltered). type: object required: - status title: ProductSearchResponse description: Response from the product search endpoint. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ProductSearchResult: properties: product_id: type: string title: Product Id title: type: string title: Title image: anyOf: - type: string - type: 'null' title: Image brand: anyOf: - type: string - type: 'null' title: Brand price: anyOf: - type: integer - type: 'null' title: Price stars: anyOf: - type: number - type: 'null' title: Stars num_reviews: anyOf: - type: integer - type: 'null' title: Num Reviews num_offers_estimate: anyOf: - type: integer - type: 'null' title: Num Offers Estimate num_sales: anyOf: - type: integer - type: 'null' title: Num Sales product_details: anyOf: - items: {} type: array - type: 'null' title: Product Details fresh: anyOf: - type: boolean - type: 'null' title: Fresh prime: anyOf: - type: boolean - type: 'null' title: Prime pantry: anyOf: - type: boolean - type: 'null' title: Pantry addon: anyOf: - type: boolean - type: 'null' title: Addon ship_price: anyOf: - type: integer - type: 'null' title: Ship Price upc: anyOf: - type: string - type: 'null' title: Upc mpn: anyOf: - type: string - type: 'null' title: Mpn available: anyOf: - type: boolean - type: 'null' title: Available available_online: anyOf: - type: boolean - type: 'null' title: Available Online available_instore: anyOf: - type: boolean - type: 'null' title: Available Instore freight_shipping: anyOf: - type: boolean - type: 'null' title: Freight Shipping preorder: anyOf: - type: boolean - type: 'null' title: Preorder first_party_seller: anyOf: - type: boolean - type: 'null' title: First Party Seller buyapi_hint: anyOf: - type: boolean - type: 'null' title: Buyapi Hint url: anyOf: - type: string - type: 'null' title: Url variant_id: anyOf: - type: string - type: 'null' title: Variant Id currency_code: anyOf: - type: string - type: 'null' title: Currency Code type: object required: - product_id - title title: ProductSearchResult description: >- Normalized product search result across retailers. Common fields are required or have defaults; retailer-specific fields are optional. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: apiKey in: header name: Authorization description: Zinc API key (Bearer zn_...) ````