> ## 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 for products on a retailer ## 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, Best Buy, Lowe's, Partstown, Pokémon Center, Target, The Home Depot, Walmart, Wayfair, and 2 more. Ships to the US and 1 other country (DE). version: '2026-07-10' 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, Best Buy, Lowe's, Partstown, Pokémon Center, Target, The Home Depot, Walmart, Wayfair, and 2 more, shipping to the US and 1 other country (DE). x-supported-retailers: - 1-800-Flowers - Ace Hardware - Amazon - Amazon DE - Best Buy - Lowe's - Partstown - Pokémon Center - Target - The Home Depot - Walmart - Wayfair - Zinc - eBay x-supported-countries: - US - DE 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. operationId: search_products_products_search_get parameters: - name: query in: query required: true schema: type: string description: Search term title: Query description: Search term - name: retailer in: query required: true schema: enum: - amazon - walmart type: string description: Retailer identifier title: Retailer description: Retailer identifier - 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: 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 v1 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. default: false title: Free Shipping description: >- Only return items that ship for free (Walmart: 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 v1 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. - 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 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_...) ````