Piloterr

Oscaro Product

GET
/v2/oscaro/product

Oscaro Product API. Fetch full auto parts product data from an Oscaro product URL. Returns pricing, brand, reference, images and availability via browser rendering and JSON-LD parsing.

Credit cost: 2 credits per call

Authentification

ApiKeyAuth
headerx-api-key<token>

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

Paramètres de requête

query*string

Oscaro product page URL (*-{sku}-p suffix).

Examples:

https://www.oscaro.com/huile-moteur-motul-102208-15213891-1862-p
https://www.oscaro.es/filtro-de-aceite-purflux-l343d-13644654-7-p

Region is auto-detected from the URL TLD.

return_page_source?boolean

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

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corps de la réponse

Successful response

application/json
  1. response
url?string
brand?string
price?number
title?string
images?array<string>
currency?string
in_stock?boolean
image_url?string
reference?string
product_id?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/oscaro/product?query=string'
Example Response
{  "url": "https://www.oscaro.com/huile-moteur-motul-102208-15213891-1862-p",  "brand": "MOTUL",  "price": 13.28,  "title": "MOTUL - SPECIFIC 0720 5W-30  1L - ref. 102208 - Huile moteur",  "images": [    "https://oscaro.media/catalog/images/oscjpg/normal/1114/specific 0720 5w30 1l.jpg"  ],  "currency": "EUR",  "in_stock": true,  "image_url": "https://oscaro.media/catalog/images/oscjpg/normal/1114/specific 0720 5w30 1l.jpg",  "reference": "102208",  "product_id": "15213891"}