Blackcircles APIblackcircles.com ↗
Look up UK vehicles by registration, search tyres by size, and get fully fitted prices with EU label ratings via the Blackcircles.com API.
What is the Blackcircles API?
The Blackcircles.com API exposes 4 endpoints covering UK vehicle registration lookups, tyre size searches, and individual tyre pricing. The search_tyres_by_vehicle endpoint accepts a registration number and postcode and returns matched tyre listings alongside vehicle details including MOT status. Each tyre result includes the fully fitted GBP price, EU label ratings for fuel efficiency, wet grip, and noise, plus load index and speed rating.
curl -X POST 'https://api.parse.bot/scraper/f22ea1ce-dba2-4bb2-805f-b789e540fbbe/search_tyres_by_vehicle' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"postcode": "EH1 1BE",
"registration": "SP55ZXL"
}'Searches for tyres by UK vehicle registration number and postcode. First looks up the vehicle to determine compatible tyre sizes, then returns tyre listings for the first available size. Results include fully fitted prices, EU tyre label ratings (fuel efficiency, wet grip, noise), season type, and run-flat status. Returns a single composite result containing vehicle details and all matching tyres (typically 15-25 per size).
| Param | Type | Description |
|---|---|---|
| postcoderequired | string | UK postcode for local fitting availability and pricing (e.g. EH1 1BE, L1 8JQ). |
| registrationrequired | string | UK vehicle registration number (e.g. SP55ZXL, BD51SMR). Letters and numbers only, no spaces required. |
{
"type": "object",
"fields": {
"tyres": "array of matching tyre listings with pricing and specifications",
"vehicle": "object containing registration, vehicle name, colour, and MOT expiry",
"tyre_sizes": "array of available tyre size options with value codes and labels",
"selected_size": "string code of the tyre size used for the search"
},
"sample": {
"data": {
"tyres": [
{
"name": "Michelin CrossClimate 3 205/55 R16 V (91)",
"price": 109.99,
"season": "all_season",
"tyre_id": "48318247",
"featured": true,
"noise_db": 72,
"run_flat": false,
"wet_grip": "B",
"noise_rating": "B",
"fuel_efficiency": "C"
}
],
"vehicle": {
"colour": "Silver",
"vehicle": "FORD FOCUS GHIA TDCI",
"mot_expiry": "18 October 2008",
"registration": "SP55ZXL"
},
"tyre_sizes": [
{
"label": "205/55R16 H 91 Fitted to front and rear",
"value": "205_55_16_H_91"
}
],
"selected_size": "205_55_16_H_91"
},
"status": "success"
}
}About the Blackcircles API
Vehicle and Tyre Size Lookup
The lookup_vehicle endpoint takes a UK registration number and returns the vehicle's make, model, trim, colour, and MOT expiry date as shown on Blackcircles. Alongside the vehicle record, it returns an array of compatible tyre sizes, each carrying the size code (usable directly as selected_size in other calls), width in mm, aspect ratio profile, rim diameter in inches, and speed rating. This is the starting point when you need to map a registration to a concrete set of tyre dimensions.
Searching Tyres by Size or Vehicle
search_tyres accepts width, profile, and rim as required inputs and an optional speed filter to narrow results by speed rating. It returns the full listing for that size — typically 20–30 tyres — in a single response with no pagination. Each entry includes tyre_id, brand, model, price (fully fitted, GBP), mail_order_price, EU label fields (fuel_efficiency, wet_grip, noise_db), run_flat, season, and a product_url suitable for passing to get_tyre.
The search_tyres_by_vehicle endpoint combines vehicle lookup and tyre search into one call. You supply a registration number and a UK postcode; the API resolves the vehicle, selects the first available tyre size, and returns tyre listings alongside the vehicle object, the full tyre_sizes array, and the selected_size code that was used.
Individual Tyre Confirmation
get_tyre takes a product_url from any tyre listing and fetches the current state of that product page. It returns the same fields as a search row — brand, model, size, speed rating, load index, fully fitted price, EU label values, run_flat flag, season, and promotion code — making it suitable for confirming a price before completing a purchase flow or for monitoring price changes on a specific tyre.
The Blackcircles API is a managed, monitored endpoint for blackcircles.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when blackcircles.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official blackcircles.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a registration-to-tyre recommendation tool that surfaces fitted prices and EU ratings for a user's specific vehicle
- Monitor price changes on specific tyre models by polling
get_tyrewith stored product URLs - Filter tyre listings by speed rating using the
speedparameter insearch_tyresfor fleet compliance checks - Display MOT expiry dates alongside tyre recommendations by consuming the
mot_datefield fromlookup_vehicle - Compare fitted vs mail-order prices across tyre sizes for cost analysis tooling
- Aggregate EU label fuel efficiency and wet grip ratings across a tyre size to rank economy or safety performance
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Blackcircles have an official developer API?+
What vehicle data does `lookup_vehicle` return beyond make and model?+
lookup_vehicle returns the vehicle's make, model, full trim description, colour, MOT expiry date, and MOT status label (for example 'MOT expired' or 'MOT due') as displayed on the site. It also includes the full array of compatible tyre sizes with their width, profile, rim, speed rating, and the size_code value you can pass to search_tyres or search_tyres_by_vehicle.Does `search_tyres` paginate results, and how many tyres does it return?+
search_tyres returns the full listing for a given size in one response. The total_results field reflects the number of distinct tyres returned, which is typically 20–30 for a common size.Does the API cover fitting centre locations or booking availability?+
Is tyre pricing specific to a location, and how is the postcode used?+
search_tyres_by_vehicle accepts a postcode input that influences local fitting availability and pricing. search_tyres and get_tyre return the fitted price without a postcode parameter, so those prices may reflect a default or nationwide rate rather than a location-specific one.