/api/v1/products/search10 creditsProduct Search API
AvailableOne product name or retailer URL in; matched candidates with merchant offers inline.
Send a product name or a retailer URL. One request returns matched products with their merchant offers inline — seller, price, currency and stock — with global coverage across supported markets.
Each Search costs 10 Search credits, and so does each item in an Async Bulk job. Every other operation — Product Snapshot, Product Snapshot Batch, Product Clusters, Price History, Catalogue lookup, Schedules — costs 0 credits.
curl -G "https://api.pricesapi.io/api/v1/products/search" \ -H "Authorization: Bearer $PRICESAPI_KEY" \ --data-urlencode "q=Sony WH-1000XM5" \ --data-urlencode "market=us"
{
"success": true,
"data": {
"query": "Sony WH-1000XM5",
"market": "us",
"products": [
{
"title": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones",
"headline_price": 329.99,
"headline_currency": "USD",
"offerCount": 3,
"offers": [
{ "seller": "Best Buy", "price": 248, "currency": "USD", "stock_status": "In stock" },
{ "seller": "Sony", "price": 249.99, "currency": "USD", "stock_status": "In stock" },
{ "seller": "Target", "price": 249.99, "currency": "USD", "stock_status": "In stock" }
]
}
]
},
"meta": { "latency_ms": 41822, "cache_source": "miss" }
}A cold call runs a live collection before it returns, so allow a 95-second timeout. A repeat of the same query is served from cache and costs the same. meta.cache_source tells you which you got. Run this query yourself →
Matched products and current merchant offers.
Read a known product without re-running discovery.
Retained observations with timestamps and gaps.
Not publicly available yet.
Return normalized product and offer data as documented JSON.
/api/v1/products/search10 creditsOne product name or retailer URL in; matched candidates with merchant offers inline.
/api/v1/products/catalog0 creditsResolve product or seller text to PricesAPI product IDs, with the retained coverage held for each.
/api/v1/products0 creditsRead one known product and market from retained evidence, without running Search.
/api/v1/products/batch0 creditsUp to 100 known product identities, in input order, with explicit per-item misses.
/api/v1/products/history0 creditsRetained price observations for a known product and market, with explicit gaps.
/api/v1/schedules0 creditsRecurring daily or weekly catalogue discovery. Management and background refreshes are free.
/api/v1/search/jobs10 credits an itemA durable one-off job of up to 100 Search items, then paged results.
https://mcp.pricesapi.io/mcpSame as RESTSearch, read, schedule and run bulk jobs from an MCP client with bearer auth.
Product Search is available now. Schedules, Async Bulk Search, Product Snapshot, and Price History are in public Beta for every valid API account. Retained-history depth varies by product and market. Product Watches are coming next and are not publicly available yet.
Pricing models, included allowances, and usage limits for all Beta features may change before general availability. Existing Product Search pricing and Search-credit allowances remain unchanged unless separately announced.
Pass a product name or a retailer URL, pick markets, and fire the same request your code will. A free account takes a minute and comes with 300 Searches — your query is carried over.
Real products and merchant offers recently processed by PricesAPI. Prices and availability change — run your own query for the current response.
Start free, upgrade in-dashboard. The voluntary 14-day guarantee applies to an initial paid self-service purchase.
Per response that returns at least one product. A cache hit costs the same as a live scrape; empty results and failed requests cost nothing.
Per item, reserved when the job is submitted — the same as a Search, because it is the same work. Empty, failed and cancelled-before-start items are refunded; checking status, reading results and cancelling cost nothing.
Per product read by its ID.
Per product returned, never per call.
Per page of cluster members.
Per product window read.
Turns product or seller text into the IDs every other operation needs. Free, so that finding an ID never costs a Search.
Creating, listing, pausing and deleting schedules is free, and a background refresh uses no credit. A later Search that returns products bills normally.
Operations that cost 0 credits do not draw on your Search rate limit, and they keep working if your Search credits run out. Only product-bearing Searches are charged.
Pricing models, included allowances, and usage limits for all Beta features may change before general availability. Existing Product Search pricing and Search-credit allowances remain unchanged unless separately announced.
Run selected searches through recurring catalogue discovery. Weekly and daily cadences are available globally across supported markets. Sub-daily cadences are not available yet.
Schedules management calls use no API credits, and there is no separate scheduling fee. Background scheduled refreshes use no API credits. A later customer-initiated non-empty Search follows normal billing.
Read the guideChoose daily or weekly globally in the dashboard or Schedules API. Sub-daily cadences are not available yet. Review whether the latest catalogue discovery is waiting, complete, or needs attention. Background scheduled refreshes use no API credits.
Free account, no card. 300 Searches to try it, then upgrade in the dashboard when you need more.