autodoc.es APIwww.autodoc.es ↗
Access Autodoc.es vehicle makes, models, variants, parts search, category listings, and full part specs including OE cross-references and fitment data.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/9c78ad41-8cdd-4c24-979f-3924df4608f8/get_vehicle_makes' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all vehicle manufacturers/makes available in the catalog. Returns a list of makers grouped by popularity with IDs usable in get_vehicle_models.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total number of makers",
"makers": "array of objects with id, name, group, euro_reg, synonyms"
},
"sample": {
"data": {
"total": 186,
"makers": [
{
"id": 16,
"name": "BMW",
"group": "Los fabricantes más reconocidos",
"euro_reg": true,
"synonyms": []
},
{
"id": 121,
"name": "VOLKSWAGEN",
"group": "Los fabricantes más reconocidos",
"euro_reg": true,
"synonyms": [
"Volkswagen",
"Volkswagen",
"Volkswagen"
]
}
]
},
"status": "success"
}
}About the autodoc.es API
The Autodoc.es API provides 6 endpoints covering the full auto parts lookup workflow on autodoc.es, from browsing vehicle manufacturers down to retrieving part-level details. The get_part_details endpoint returns OE cross-reference numbers, EAN barcodes, pricing, images, and vehicle compatibility for a specific article. Combined with vehicle selection endpoints and search_parts, it supports end-to-end parts identification for the Spanish-language Autodoc catalog.
Vehicle Hierarchy
get_vehicle_makes returns the complete manufacturer list with each maker's id, name, group, euro_reg flag, and synonyms. Pass the id into get_vehicle_models to get a grouped model list with series names, then pass any model_id into get_vehicle_variants to retrieve variants with fuel_type and euro_reg data. These three endpoints form the selection chain that produces the car_slug values used to filter category results downstream.
Parts Search and Category Browsing
search_parts accepts a Spanish-language keyword (e.g. pastillas de freno) or an exact part number. Results come back grouped by group_type, with each item carrying a title, url, optional thumbnail, and article_id where applicable. Since the Autodoc.es catalog is in Spanish, English-language keywords produce weaker matches. get_category_parts takes a category_slug (e.g. disco-de-freno-10132) and an optional car_slug to filter by vehicle, returning paginated rows with article_id, part_number, brand_name, price, rrp_price, and currency.
Part Details and Cross-References
get_part_details takes an article_id and a lowercase brand_slug and returns the full record: name, ean, sku, images array, price, rrp_price, currency, and an oe_numbers array where each entry lists the OE number alongside the vehicle brands it applies to. This makes it practical to match a part against manufacturer OE catalogs or find interchange alternatives without leaving the API response.
Pagination and Language Notes
get_category_parts exposes total_pages and total_parts fields so you can walk through large category results page by page using the page parameter. All slugs and keywords are Spanish — the category_slug must include the numeric ID suffix (e.g. pastillas-de-freno-10131), and the car_slug follows the path pattern visible in Autodoc.es URLs (e.g. vw/golf/golf-v-variant-1k5/23263-1-4).
- Build a vehicle-specific parts catalog by chaining make → model → variant → category endpoints
- Cross-reference OE part numbers against Autodoc.es aftermarket alternatives using
oe_numbersinget_part_details - Monitor price changes on specific parts by polling
get_category_partsorget_part_detailsforpriceandrrp_price - Verify part fitment for a given vehicle by filtering
get_category_partswith acar_slug - Identify parts by exact part number using
search_partswith a numeric part reference - Aggregate brand and category coverage data by iterating
get_vehicle_makesandget_category_partsresults
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Autodoc.es have an official developer API?+
What does `get_part_details` return beyond price?+
get_part_details returns the part's ean barcode, sku, full name, brand, an images array, rrp_price, currency, and an oe_numbers array. Each entry in oe_numbers includes the OE number string and a brands array listing which vehicle manufacturers use it. You need both article_id and brand_slug as inputs.Does the API return user reviews or ratings for parts?+
How does keyword language affect `search_parts` results?+
pastillas de freno for brake pads, disco de freno for brake disc) return more complete results than English equivalents. Exact part numbers like 09.9167.11 match directly regardless of language.Are truck, motorcycle, or commercial vehicle parts covered?+
get_vehicle_makes endpoint returns all manufacturers in the catalog, and coverage depends on what Autodoc.es lists — which skews toward passenger cars. Motorcycle and heavy commercial vehicle catalogs may have limited or no coverage. You can fork the API on Parse and revise it to target any specialist vehicle category Autodoc.es exposes.