Piloterr

Oscaro Search

GET
/v2/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

Autorisierung

ApiKeyAuth
x-api-key<token>

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

In: header

Abfrageparameter

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.

Antworttext

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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"}