Skip to content
Scrappa Get API key
RockAuto API 1 credit / request

RockAuto Search API Documentation

GET https://scrappa.co/api/rockauto/search

RockAuto Search API searches public car-part listings. Send query with a carcode, or part_number alone. Each item has brand, part number, price and core charge as numbers with currency, availability, a full-size image URL, and the ids (part_key, car_code, part_type) that the product route accepts unchanged.

Only page 1 is available; RockAuto has no public continuation token, so page accepts only 1. Shipped language variants are en, de and fr. Prices are numbers; RockAuto shows no list price, so original_price and discount are null, and core_charge is a refundable deposit. A request with no results or a failed request is never billed. Costs 1 credit per successful request.

RockAuto Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/rockauto/search
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops part_number = example
Response preview
200 OK
{
    "data": {
        "page": 1,
        "count": 1,
        "items": [
            {
                "name": "FMG PSG1056",
                "brand": "FMG",
                "price": 9.5,
                "total": 9.5,
                "rating": null,
                "car_code": "3440320",
                "currency": "EUR",
                "discount": null,
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

2 required parameters needed before sending a request.

6 optional filters available.

query string Required

Search text, 1 to 120 characters, for example brake pad. Requires carcode.

Example value coffee shops
part_number string Required

A part number to look up, for example 10032116C. Use this or query, not both.

Example value example
make string Optional

Optional vehicle filter for query search. Cannot be combined with part_number.

Example value example
year string Optional

Optional vehicle filter for query search. Cannot be combined with part_number.

Example value example
model string Optional

Optional vehicle filter for query search. Cannot be combined with part_number.

Example value example
carcode string Optional

Numeric vehicle id from a RockAuto vehicle catalog URL or from car_code in a previous search. Required with query; forbidden with part_number.

Example value example
language string Optional

en, de or fr (default en). Other variants are not available.

Example value en
page integer Optional

Only 1 is available. Any other value answers 422.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "page": 1,
        "count": 1,
        "items": [
            {
                "name": "FMG PSG1056",
                "brand": "FMG",
                "price": 9.5,
                "total": 9.5,
                "rating": null,
                "car_code": "3440320",
                "currency": "EUR",
                "discount": null,
                "part_key": "18570437",
                "position": 1,
                "image_url": "https://www.rockauto.com/info/1277/1277_PSG1056_1.jpg",
                "part_type": "1684",
                "detail_url": "https://www.rockauto.com/en/moreinfo.php?pk=18570437&cc=3440320&pt=1684",
                "partnumber": "PSG1056",
                "sale_price": 9.5,
                "scraped_at": "2026-11-17T12:00:00+00:00",
                "core_charge": 0,
                "part_number": "PSG1056",
                "availability": true,
                "review_count": null,
                "quality_group": "Economy",
                "original_price": null,
                "warehouse_stock": null
            }
        ],
        "query": "brake pad",
        "vehicle": {
            "make": "DODGE",
            "year": "2018",
            "model": "CHARGER",
            "engine": "3.6L V6",
            "car_code": "3440320",
            "part_type": "1684"
        },
        "currency": "EUR",
        "language": "en",
        "part_number": null,
        "has_next_page": false
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Invalid Parameter

A filter cannot be honoured, for example page above 1 or an unavailable language. Not billed.

404

Not Found

No parts were found. Not billed.

503

Upstream Unavailable

RockAuto could not be reached. Not billed. Retry shortly.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.