Skip to main content
Piloterr
Back to library

Oscaro Product API

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.

Active2 credits = 1 requestGET/v2/oscaro/product

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Oscaro Product API returns full product page data from Oscaro shops. Pass a product URL (*-{sku}-p) and receive structured JSON with pricing, brand, reference, images, ratings, and availability.

Piloterr uses browser rendering, waits for .price, then parses JSON-LD @type: Product (fallback: DOM h1 + .price + id from URL).

Use Oscaro Search to discover listings, then Oscaro Product for the full record.

Supported regionsLink to Supported regions

Region is auto-detected from the product URL TLD (oscaro.com, oscaro.es, oscaro.pt).

Domain Currency
oscaro.com EUR
oscaro.es EUR
oscaro.pt EUR

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/oscaro/product?query=https://www.oscaro.com/huile-moteur-motul-102208-15213891-1862-p
GET https://api.piloterr.com/v2/oscaro/product?query=https://www.oscaro.es/filtro-de-aceite-purflux-l343d-13644654-7-p

ParametersLink to Parameters

Parameter Type Required Description
query string yes Product page URL (-p suffix)
return_page_source boolean no Raw HTML as {\"result\": \"...\"} (default: false)

Response fieldsLink to Response fields

Field Type Description
product_id string SKU from JSON-LD (sku)
title string Product name
url string Canonical product URL
price number | null Current price
currency string ISO currency
brand string | null Brand name
reference string | null Manufacturer part number (mpn)
image_url string | null Main image
images string[] | null Image gallery
description string | null Long description (when exposed)
rating number | null Average rating
review_count integer | null Review count
in_stock boolean | null Online availability

Oscaro workflowLink to Oscaro workflow

  1. Oscaro Search to discover listings
  2. Oscaro Product for full PDP JSON (this endpoint)

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query
404 Unparsable or missing product page
500 Rendering or parsing error

NotesLink to Notes

  • Product URLs end with -p (e.g. 15213891-1862-p).
  • Costs 2 credits per call (browser rendering).

Main use casesLink to Main use cases

  • PDP enrichment: brand, reference, gallery, ratings
  • Price monitoring: track part prices across Oscaro shops
  • Stock checks: in_stock from JSON-LD availability

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included