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.

Create a Markets key

Solo, Team and Scale · Markets Day Pass

Try Markets free

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

POST/v1/markets/listings
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" }'
201application/json
{  "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

GET/v1/markets/listings/{id}
curl https://api.crawlbench.com/v1/markets/listings/8Kq2Vd41xP \  -H "Authorization: Bearer $CB_KEY"
200application/json
{  "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

DELETE/v1/markets/listings/{id}
curl -X DELETE https://api.crawlbench.com/v1/markets/listings/8Kq2Vd41xP \  -H "Authorization: Bearer $CB_KEY"
204No content
HTTP/1.1 204 No Content

The 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.

POST/v1/markets/estimates
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"}'
201application/json
{  "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.

Markets routes
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.

Markets webhook events
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.

Limits by plan
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.

Past a limit
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.

Create a Markets key

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.

Book a demo

Free · 30 minutes · Video call