The 5stones API

Fresh marketplace data at any scale, through one API.

Realtime answers in seconds, whole catalogs in bulk, and every hard part of data collection handled for you. One reliable API for clean, structured data, priced per result. No credit card: 1,000 free credits every month, and a product costs 2 credits in bulk, 3 in realtime.

Start with 1,000 free credits Browse the endpoints

Two ways to call it

The same operations, the same schema, and the same key, whether you need one answer right now or a whole catalog by morning.

Realtime

Fast on every call, not just on average

Most data APIs add seconds of overhead on top of the page itself. The 5stones API answers in typically 1 to 3 seconds, call after call, so you can put live data directly behind a product page, a pricing engine, or an agent's next step.

  • One GET, one answer. Nothing to poll
  • Fetched live at request time, stamped observedAt + zipCode
  • Typed JSON with a stable schema, documented per field
Bulk

Whole catalogs, streamed as they land

Send up to 1,000,000 lines per batch and as many batches as you need. Rows stream in the moment they are fetched, so you start working with results right away instead of waiting for the whole job to finish.

  • Read results while the job runs, or take a webhook at the end
  • Retries happen automatically, so every job comes back fresh and complete
  • Same operations, same schema, cheaper per row: 2 credits a product instead of 3

One call, one answer

curl -H "Authorization: Bearer $FRESHCRAWL_KEY" \
  https://api.freshcrawl.io/v1/walmart-us/items/20708870822

We handle the hard parts

Retries, load balancing, slow and flaky pages, parsing, keeping up when a site changes: that is our job. You call one reliable API and get clean results.

Retries and load balancing happen automatically, so your requests just succeed. In the rare case a request cannot be answered, you get a precise reason your code can act on. A failure on our side is never billed.

404 · not_found

Verified 404

The item does not exist at the source. We verify every 404 before returning it, so you can trust it. Costs 1 credit.

503 · service_unavailable

Never billed

A brief, rare issue on our side. Safe to retry right away. A 503 is never billed, and neither is any other failure on our side.

Many sources, one API

Same key, same envelope, same billing for every source. Walmart US, Walmart Business, and Amazon US are live. More ecommerce data is coming soon.

Walmart US Live · 8 endpoints Walmart Business Live · 4 endpoints Amazon US Live · 6 endpoints More ecommerce data Coming soon

Walmart US

OperationEndpointReturnsCredits bulk / realtime
Item details & Buy Box
walmart-us.items.get
GET /v1/walmart-us/items/{itemId} Full product page data for one item: title, brand, price, Buy Box offer, stock, shipping. 2 / 3
All-seller offers
walmart-us.items.offers.list
GET /v1/walmart-us/items/{itemId}/offers Every seller's offer on one item's Buy Box slot, with price, condition and fulfilment. 3 / 4
Seller profile
walmart-us.sellers.get
GET /v1/walmart-us/sellers/{sellerId} A seller's storefront record: name, rating, contact info and status. 2 / 3
Seller catalog page
walmart-us.sellers.items.list
GET /v1/walmart-us/sellers/{sellerId}/items One page of a seller's product catalog, with price and availability per item. 2 + 2 / 2 + 3 per page
Search results
walmart-us.search.list
GET /v1/walmart-us/search?q=… Full result tiles for one page of a Walmart search query. 2 / 3
Reviews & rating summary
walmart-us.items.reviews.list
GET /v1/walmart-us/items/{itemId}/reviews Reviews and the rating summary for one item, one page. 2 / 3
Category listing page
walmart-us.categories.items.list
GET /v1/walmart-us/categories/{categoryId}/items One page of a Walmart category listing (e.g. best sellers), with every field of every product tile. 2 / 3
Related products
walmart-us.items.related.list
GET /v1/walmart-us/items/{itemId}/related Every recommendation shelf of one item page (similar items, popular in category, frequently bought together, …), with every field of every product tile. 2 / 3

Walmart Business

OperationEndpointReturnsCredits bulk / realtime
Business item details & Buy Box
walmart-business-us.items.get
GET /v1/walmart-business-us/items/{itemId} Full Walmart Business product page data for one item: price, Buy Box offer with its business stock, volume pricing and business-price flag, every product field. 2 / 3
Business all-seller offers
walmart-business-us.items.offers.list
GET /v1/walmart-business-us/items/{itemId}/offers Every seller's offer on one item on Walmart Business, each with its business stock, order limits and volume pricing. 3 / 4
Business search results
walmart-business-us.search.list
GET /v1/walmart-business-us/search?q=… Full result tiles for one page of a Walmart Business search, with each tile's business price flag and volume pricing. 2 / 3
Business reviews & rating summary
walmart-business-us.items.reviews.list
GET /v1/walmart-business-us/items/{itemId}/reviews The rating summary and the reviews the Walmart Business item page shows for one item. 2 / 3

Amazon US

OperationEndpointReturnsCredits bulk / realtime
Amazon product details & buy box
amazon-us.items.get
GET /v1/amazon-us/items/{itemId} Every field of one Amazon product page: title, buy box price, availability and seller, ratings, bullets, details, images, breadcrumb and variations. 2 / 3
Amazon all-seller offers
amazon-us.items.offers.list
GET /v1/amazon-us/items/{itemId}/offers Every offer on Amazon's offers panel for one product: condition, price, seller, delivery promises and promotions. 3 / 4
Amazon seller profile
amazon-us.sellers.get
GET /v1/amazon-us/sellers/{sellerId} One Amazon seller's profile: name, feedback summary and histograms, about texts, published business details and policies. 2 / 3
Amazon seller's products
amazon-us.sellers.items.list
GET /v1/amazon-us/sellers/{sellerId}/items One page of the products an Amazon seller lists, every field of each product card. 2 + 2 / 2 + 3 per page
Amazon search results
amazon-us.search.list
GET /v1/amazon-us/search?q=… One page of Amazon search results: every product card and the page-level blocks (result count, refinements, related searches). 2 / 3
Amazon category listing
amazon-us.categories.items.list
GET /v1/amazon-us/categories/{categoryId}/items One page of an Amazon category (browse node) listing: every product card and the page-level blocks. 2 / 3

Built for agents

Docs your agent can read. Every operation has plain Markdown docs an LLM can fetch and follow, generated straight from the API spec. Humans get interactive docs in the console with their key already selected.

Markdown docs

Point your agent at one URL: a Markdown index of every operation, with parameters, response fields, errors, prices, and curl, TypeScript, and Python examples.

api.freshcrawl.io/docs/agents

OpenAPI spec

The full OpenAPI spec describes every operation, so agents and code generators can build against the API without guesswork. Errors are application/problem+json with stable machine-readable codes.

api.freshcrawl.io/openapi.json

MCP access

5stones also includes an MCP interface that allows compatible AI and software systems to work with available platform data and tools through a structured connection.

More about the platform

Point your agent at one URL

curl https://api.freshcrawl.io/docs/agents/index.md

Buy credits once. Spend them at your pace.

Every package unlocks every source and endpoint, realtime and bulk. Pay once, no subscription: credits never expire, and bigger packages cost less per credit. You also get 1,000 free credits every month, no credit card required.

Starter

$87 once

250,000 credits

  • $0.348 per 1,000 credits
  • ≈ 125k products in bulk
Get Starter

Growth

$275 once

1,000,000 credits

  • $0.275 per 1,000 credits
  • ≈ 500k products in bulk
Get Growth

Volume

$3,300 once

20,000,000 credits

  • $0.165 per 1,000 credits
  • ≈ 10M products in bulk
Get Volume

Enterprise

$13,000 once

100,000,000 credits

  • $0.130 per 1,000 credits
  • ≈ 50M products in bulk
Get Enterprise

The smallest package is $87. Need more than 100M credits? Talk to us.

Credits per call

Call typeBulk (async)Realtime (sync)
Product per product23
Product + every seller offer per product57
Search results per results page23
Category listing per listing page23
Seller profile per seller23
Seller catalog per 5-page catalog1217
Reviews per reviews page23
Buy box mapper 51-state map, batch only102—
Item does not exist a verified 40411
Request we could not answer failed or timed out00

1,000 free credits monthly

Sign up and you get 1,000 free credits right away, and we top your balance back up to 1,000 every month. No credit card required.

Credits never expire

A package is a one-time payment, and its credits stay on your balance until you use them. There is no subscription to cancel.

Safety rate limits

Free and trial accounts: 60 requests/min, 5 concurrent. Accounts with purchased credits: 6,000 requests/min, 120 concurrent.

Frequently asked questions

How fast is a realtime call?

Typically 1 to 3 seconds, call after call. There is nothing to poll: one GET, one answer.

How fresh is the data?

Every call is a live fetch at request time. Each response carries meta.observedAt, the exact moment the data was collected, and meta.zipCode, the US ZIP code it was collected for, because prices, stock and delivery promises depend on location.

How reliable is it?

Retries and load balancing happen automatically, so your requests just succeed. In the rare case a request cannot be answered, you get a precise reason: a 404 means the item does not exist at the source (we verify every 404 before returning it, and it costs 1 credit), and a 503 means a brief issue on our side that is safe to retry right away and is never billed.

Do I have to wait for a bulk job to finish?

No. Rows are available the moment they are fetched: page through the results while the job is still running, or take a webhook when it is done. Retries happen automatically along the way.

What does a call cost?

It depends on the call and how you send it. A product costs 2 credits in a batch or 3 on demand; the credits-per-call table above lists every call type. An item that does not exist costs 1 credit, and a request we fail to answer costs nothing. The price is in meta.credits on every response and result.

Do credits expire?

No. A package is a one-time payment, and its credits stay on your balance until you use them. Buy a bigger package when you want a lower price per credit; there is no subscription to cancel.

Which package should I buy?

Start from your expected monthly calls and the credits-per-call table above: pick the smallest package that covers your month. Larger packages cost less per credit, so a package that lasts several months is often the better deal.

Are there rate limits?

Only safety limits that protect you from a runaway script: free and trial accounts can send 60 requests a minute with 5 in flight; accounts with purchased credits can send 6,000 requests a minute with 120 in flight. Need more? Write to [email protected].

Which sources are available?

Walmart US (walmart.com, 8 endpoints), Walmart Business (business.walmart.com, 4 endpoints) and Amazon US (amazon.com, 6 endpoints) are live today. More ecommerce data is coming soon, all behind the same API, key and billing.

Which location is Amazon data collected for?

ZIP code 75201 (Dallas, TX). Prices, availability and delivery promises are those Amazon shows there, and meta.zipCode names it on every response and result.

Can my AI agent use it directly?

Yes. Every operation has plain Markdown docs at api.freshcrawl.io/docs/agents, the full OpenAPI spec is at api.freshcrawl.io/openapi.json, and errors are application/problem+json with stable machine-readable codes.

Do I need a credit card to start?

No. Sign up and you get 1,000 free credits right away, enough for about 333 on-demand product calls, and we top your balance back up to 1,000 every month.

Start with one call. Scale to whole catalogs.

1,000 free credits on sign-up, no credit card. Same API at every size.

Start with 1,000 free credits