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.
The 5stones 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.
The same operations, the same schema, and the same key, whether you need one answer right now or a whole catalog by morning.
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.
GET, one answer. Nothing to pollobservedAt + zipCodeSend 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.
One call, one answer
curl -H "Authorization: Bearer $FRESHCRAWL_KEY" \
https://api.freshcrawl.io/v1/walmart-us/items/20708870822
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.
The item does not exist at the source. We verify every 404 before returning it, so you can trust it. Costs 1 credit.
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.
Same key, same envelope, same billing for every source. Walmart US, Walmart Business, and Amazon US are live. More ecommerce data is coming soon.
| Operation | Endpoint | Returns | Credits bulk / realtime |
|---|---|---|---|
Item details & Buy Boxwalmart-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 offerswalmart-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 profilewalmart-us.sellers.get |
GET /v1/walmart-us/sellers/{sellerId} |
A seller's storefront record: name, rating, contact info and status. | 2 / 3 |
Seller catalog pagewalmart-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 resultswalmart-us.search.list |
GET /v1/walmart-us/search?q=… |
Full result tiles for one page of a Walmart search query. | 2 / 3 |
Reviews & rating summarywalmart-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 pagewalmart-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 productswalmart-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 |
| Operation | Endpoint | Returns | Credits bulk / realtime |
|---|---|---|---|
Business item details & Buy Boxwalmart-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 offerswalmart-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 resultswalmart-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 summarywalmart-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 |
| Operation | Endpoint | Returns | Credits bulk / realtime |
|---|---|---|---|
Amazon product details & buy boxamazon-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 offersamazon-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 profileamazon-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 productsamazon-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 resultsamazon-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 listingamazon-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 |
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.
Point your agent at one URL: a Markdown index of every operation, with parameters, response fields, errors, prices, and curl, TypeScript, and Python examples.
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.
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.
Point your agent at one URL
curl https://api.freshcrawl.io/docs/agents/index.md
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.
$87 once
250,000 credits
$275 once
1,000,000 credits
$1,075 once
5,000,000 credits
$3,300 once
20,000,000 credits
$13,000 once
100,000,000 credits
The smallest package is $87. Need more than 100M credits? Talk to us.
| Call type | Bulk (async) | Realtime (sync) |
|---|---|---|
| Product per product | 2 | 3 |
| Product + every seller offer per product | 5 | 7 |
| Search results per results page | 2 | 3 |
| Category listing per listing page | 2 | 3 |
| Seller profile per seller | 2 | 3 |
| Seller catalog per 5-page catalog | 12 | 17 |
| Reviews per reviews page | 2 | 3 |
| Buy box mapper 51-state map, batch only | 102 | — |
| Item does not exist a verified 404 | 1 | 1 |
| Request we could not answer failed or timed out | 0 | 0 |
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.
A package is a one-time payment, and its credits stay on your balance until you use them. There is no subscription to cancel.
Free and trial accounts: 60 requests/min, 5 concurrent. Accounts with purchased credits: 6,000 requests/min, 120 concurrent.
Typically 1 to 3 seconds, call after call. There is nothing to poll: one GET, one answer.
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.
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.
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.
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.
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.
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.
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 support@freshcrawl.io.
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.
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.
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.
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.
1,000 free credits on sign-up, no credit card. Same API at every size.
Start with 1,000 free credits