> ## 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.
# Agent Search
> Cross-retailer product search for agents, paid per call via MPP.
**Beta** — the response shape may change without notice while this endpoint is in active development.
`GET /agent/search` is the agent-native counterpart to [Cross-Retailer Search](/v2/api-reference/search/cross-retailer). It returns a single ranked list of buyable products across every supported retailer, and each result's `url` can be passed straight to [Create MPP Order](/v2/api-reference/agent/create-order) — no opaque sku id, the URL is the contract.
No Zinc account is required. Like the other `/agent/*` data endpoints, this call is paid per request via the [Machine Payments Protocol (MPP)](/v2/mpp): if no valid payment credential is provided, the API returns `402 Payment Required` with a `WWW-Authenticate` challenge for each configured payment method.
## Pricing
| | |
| ----------- | ---------------------------------------- |
| **Price** | \$0.01 per call (fixed) |
| **Payment** | MPP (HTTP 402 challenge-credential flow) |
| **Account** | Not required |
Use `/agent/search` to discover orderable URLs, then feed the chosen `url` directly into [`POST /agent/orders`](/v2/api-reference/agent/create-order) to buy it — no account, no API key.
## 402 Payment Required
If no valid payment credential is provided, the API returns `402 Payment Required` with one `WWW-Authenticate` header per payable method (per RFC 9110 §11.6.1). Your MPP client uses these to complete payment and resubmit the request. See the [MPP guide](/v2/mpp) for a full walkthrough.
## OpenAPI
````yaml versions/latest.json GET /agent/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:
/agent/search:
get:
tags:
- agent
summary: Agent Search
description: >-
**Beta** — response shape may change. Cross-retailer product search for
agents. Returns orderable listings whose
`url` can be passed straight to POST /agent/orders.
operationId: agent_search_agent_search_get
parameters:
- name: q
in: query
required: true
schema:
type: string
description: Search term
title: Q
description: Search term
- 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/SearchResponse'
'402':
description: Payment required — returns an MPP challenge for each payable method
headers:
WWW-Authenticate:
description: >-
One header per payable method with challenge parameters (per RFC
9110 §11.6.1)
schema:
type: string
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security: []
components:
schemas:
SearchResponse:
properties:
status:
type: string
title: Status
query:
type: string
title: Query
results:
items:
$ref: '#/components/schemas/Sku'
type: array
title: Results
default: []
type: object
required:
- status
- query
title: SearchResponse
description: Response from the cross-retailer search endpoint.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
Sku:
properties:
url:
type: string
title: Url
retailer:
type: string
title: Retailer
title:
anyOf:
- type: string
- type: 'null'
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
available:
anyOf:
- type: boolean
- type: 'null'
title: Available
type: object
required:
- url
- retailer
title: Sku
description: A cross-retailer buyable listing. Pass `url` to /orders to buy it.
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_...)
````