Developers
The Markets API
Track your own Marketplace listings from your code. Each one gets a price rating against similar listings and stays current on your plan's schedule. Ask for the usual price of an item before its ad goes up.
Solo, Team and Scale · Markets Day Pass
Solo for 24 hours · No credit card
Overview
The Markets API is part of the Crawlbench API. It reads and changes the listings you track in Markets, the same ones Your listings shows in the app.
- Base URL
https://api.crawlbench.com/v1/markets- Keys
- Make a key in Developers, opened from Markets, and send
Authorization: Bearer <key>on every call. A key made in Markets works only for Markets. A key is shown once. - Format
- JSON in and out. Times in UTC, ISO 8601 with
Z. Money in major units, in the listing’s own currency, with its code. - Plans
- The API comes with Solo and up, and with the Markets Day Pass for its 24 hours. Webhooks and the CSV export come with Team.
Quickstart: track a listing
Keep your key in CB_KEY. Send a Marketplace link. We check it, give it a price rating against similar listings and keep it current.
1Add a listing
curl https://api.crawlbench.com/v1/markets/listings \ -H "Authorization: Bearer $CB_KEY" \ -H "Idempotency-Key: add-2f81c0d4" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.facebook.com/marketplace/item/1234567890123456" }'{ "id": "8Kq2Vd41xP", "url": "https://www.facebook.com/marketplace/item/1234567890123456", "state": "pending", "title": null, "ask": null, "currency": null, "usual": null, "rating": null, "rating_label": null, "sample_size": null, "thin": null, "similar_listings": null, "days_listed": null, "checked_at": null, "estimate": null}Send a new Idempotency-Key with every add. A retry with the same key gets the first answer back and adds nothing twice. A link you already track answers the row you have.
2Read it once it is rated
curl https://api.crawlbench.com/v1/markets/listings/8Kq2Vd41xP \ -H "Authorization: Bearer $CB_KEY"{ "id": "8Kq2Vd41xP", "url": "https://www.facebook.com/marketplace/item/1234567890123456", "state": "tracking", "title": "2019 Honda Civic LX", "ask": 14500.0, "currency": "USD", "usual": 16200.0, "rating": "good_price", "rating_label": "Good price", "sample_size": 23, "thin": false, "similar_listings": { "scope": "country", "url": "https://app.crawlbench.com/markets/yours/8Kq2Vd41xP" }, "days_listed": 6, "checked_at": "2026-11-16T09:12:00Z", "estimate": null}The state reads pending until the first check, then tracking. When a listing leaves Marketplace it reads left.
3Stop tracking
curl -X DELETE https://api.crawlbench.com/v1/markets/listings/8Kq2Vd41xP \ -H "Authorization: Bearer $CB_KEY"HTTP/1.1 204 No ContentThe listing leaves Your listings and frees its place on your plan. Adding it again counts as a new add.
Price before listing
Send an item's category, its facts and where it is, before the ad goes up. You get the usual asking price, its range and the closest similar listings, with their Marketplace links.
curl https://api.crawlbench.com/v1/markets/estimates \ -H "Authorization: Bearer $CB_KEY" \ -H "Idempotency-Key: estimate-7c1e9a20" \ -H "Content-Type: application/json" \ -d '{ "category": "vehicles", "facts": { "year": 2019, "make": "Toyota", "model": "Camry", "variant": "SE", "mileage_mi": 48000, "condition": "used_good" }, "place": "Dallas", "country": "US"}'{ "id": "Rt7mQ2xk9B", "level": "sure", "reason": null, "category": "vehicles", "currency": "USD", "based_on": "asking_prices", "usual": 18900.0, "low": 17500.0, "high": 20400.0, "sample_size": 31, "thin": false, "same_model_count": 24, "place": { "name": "Dallas", "country": "US" }, "inputs": [ { "name": "year", "value": "2019", "used": true, "reason": "Read to find similar cars." }, { "name": "make", "value": "Toyota", "used": true, "reason": "Read to find similar cars." }, { "name": "model", "value": "Camry", "used": true, "reason": "Read to find similar cars." }, { "name": "variant", "value": "SE", "used": true, "reason": "Read to find similar cars." }, { "name": "mileage_mi", "value": "48000", "used": true, "reason": "Read, and moves the usual price by how far similar cars have been driven." }, { "name": "condition", "value": "used_good", "used": false, "reason": "Condition never moves a car's price." } ], "similar_listings": [ { "title": "2019 Toyota Camry SE", "ask": 18900, "year": 2019, "mileage_mi": 46200, "odometer": "46,200 mi", "distance_km": 3.4, "days_listed": 4, "url": "https://www.facebook.com/marketplace/item/8812345067891234", "same_model": true }, { "title": "2019 Toyota Camry SE", "ask": 19400, "year": 2019, "mileage_mi": 51800, "odometer": "51,800 mi", "distance_km": 6.1, "days_listed": 2, "url": "https://www.facebook.com/marketplace/item/8823456178902345", "same_model": true }, { "title": "2019 Toyota Camry LE", "ask": 17800, "year": 2019, "mileage_mi": 49500, "odometer": "49,500 mi", "distance_km": 8.7, "days_listed": 9, "url": "https://www.facebook.com/marketplace/item/8834567289013456", "same_model": true }, { "title": "2019 Toyota Camry XSE", "ask": 20400, "year": 2019, "mileage_mi": 44100, "odometer": "44,100 mi", "distance_km": 11.2, "days_listed": 6, "url": "https://www.facebook.com/marketplace/item/8845678390124567", "same_model": true }, { "title": "2019 Toyota Camry SE", "ask": 18500, "year": 2019, "mileage_mi": 57300, "odometer": "57,300 mi", "distance_km": 14.8, "days_listed": 3, "url": "https://www.facebook.com/marketplace/item/8856789401235678", "same_model": true }, { "title": "2019 Honda Accord Sport", "ask": 19200, "year": 2019, "mileage_mi": 47900, "odometer": "47,900 mi", "distance_km": 17.5, "days_listed": 5, "url": "https://www.facebook.com/marketplace/item/8867890512346789", "same_model": false }, { "title": "2019 Toyota Camry SE", "ask": 18200, "year": 2019, "mileage_mi": 61400, "odometer": "61,400 mi", "distance_km": 21.3, "days_listed": 11, "url": "https://www.facebook.com/marketplace/item/8878901623457890", "same_model": true }, { "title": "2019 Toyota Camry LE", "ask": 17500, "year": 2019, "mileage_mi": 53600, "odometer": "53,600 mi", "distance_km": 26.9, "days_listed": 7, "url": "https://www.facebook.com/marketplace/item/8889012734568901", "same_model": true }, { "title": "2019 Honda Accord EX", "ask": 19900, "year": 2019, "mileage_mi": 42800, "odometer": "42,800 mi", "distance_km": 33.0, "days_listed": 1, "url": "https://www.facebook.com/marketplace/item/8890123845679012", "same_model": false }, { "title": "2019 Toyota Camry SE", "ask": 19600, "year": 2019, "mileage_mi": 39700, "odometer": "39,700 mi", "distance_km": 40.6, "days_listed": 8, "url": "https://www.facebook.com/marketplace/item/8901234956780123", "same_model": true } ], "created_at": "2026-11-17T09:30:00Z"}level reads sure (the usual price and its range), thin (the range alone) or none (too few, or too far apart, to say), and reason says why. A place is a postcode or a town, always with its two-letter country. Each estimate counts as one of your adds a day.
Reference
Every Markets route. The full reference, with every field, is built from https://api.crawlbench.com/v1/openapi.json.
| POST /v1/markets/listings | Track a listing |
| GET /v1/markets/listings | Your tracked listings, 100 a page |
| GET /v1/markets/listings.csv | Your tracked listings as a CSV file, on Team |
| GET /v1/markets/listings/{id} | One tracked listing |
| DELETE /v1/markets/listings/{id} | Stop tracking |
| GET /v1/markets/usage | Calls, adds and tracked listings used |
| POST /v1/markets/estimates | Estimate a price before listing |
Webhooks, on Team
Add an endpoint in Developers, opened from Markets, and pick the events it gets. Each message is signed and sent the same way as every Crawlbench webhook: check the signature.
| tracked_listing.ready | A listing you added is checked and has its price rating. |
| tracked_listing.price_changed | Its ask went up or down. |
| tracked_listing.rating_changed | Its price rating moved, say from Fair price to Good price. |
| tracked_listing.left | It left Marketplace. The event says sold or gone. |
Limits by plan
Calls count across all your Markets keys. Adds count everywhere you add: the web, a CSV, Price check and the API. The Markets Day Pass has Solo's limits for its 24 hours.
| Free | No API | No API | 2 |
| Solo | 60 | 10 a key | 50 |
| Team | 300 | 10 a key | 500 |
| Scale | 1,200 | 10 a key | In your contract |
Errors
Each error has a code, a stable word your code can check, and a message, a plain sentence you can show. A 429 carries Retry-After.
HTTP/1.1 429 Too Many RequestsRetry-After: 12 { "error": { "code": "rate_limited", "message": "Over 60 calls in a minute. Try again in 12 seconds." }}Create a Markets key
Make a key in Developers, opened from Markets, then run the quickstart with it. Each key is shown once.
Solo, Team and Scale · Markets Day Pass
Talk to our team
Tell us what you want to build on Markets, and see the plan and the limits that fit it.
Free · 30 minutes · Video call