Piloterr

Oscaro Search

Oscaro Search API. Search auto parts by keyword, search URL or category listing on oscaro.com, oscaro.es and oscaro.pt. Returns prices and pagination via browser rendering.

Credit cost: 2 credits per call

GET
/v2/oscaro/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Search keyword, search URL, or category listing URL (*-{id}-g).

Examples:

moteur ai
https://www.oscaro.com/fr/search?q=moteur+ai
https://www.oscaro.com/huile-moteur-1862-g

Use Oscaro Product on any result url for full PDP data.

region?string

Target shop when query is a keyword (default: com).

Examples: com, fr, es, pt

Ignored when query is a full Oscaro URL.

page?number

1-based page number override for category listing URLs (default: read from URL or 1). Uses ?page=2 on *-g pages.

Range1 <= value <= 500
return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/oscaro/search?query=string"
{
  "results": [
    {
      "url": "https://www.oscaro.com/moteur-electrique-pulseur-dair-habitacle-magneti-marelli-069412247010-13361124-793-p",
      "price": 91.79,
      "title": "Moteur électrique, pulseur d'air habitacle MAGNETI MARELLI - 069412247010",
      "currency": "EUR",
      "image_url": "https://oscaro.media/catalog/images/jpg/normal/95/mt_mte247ax-wr.jpg",
      "product_id": "13361124-793"
    },
    {
      "url": "https://www.oscaro.com/moteur-electrique-pulseur-dair-habitacle-magneti-marelli-069412215010-13485530-793-p",
      "price": 47.6,
      "title": "Moteur électrique, pulseur d'air habitacle MAGNETI MARELLI - 069412215010",
      "currency": "EUR",
      "image_url": "https://oscaro.media/catalog/images/jpg/normal/95/mt_mte215ax_wr.jpg",
      "product_id": "13485530-793"
    }
  ],
  "pagination": {
    "next": null,
    "page": 1,
    "per_page": 50,
    "total_pages": null,
    "total_results": null
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}