Skip to main content
Network status
Log in
Piloterr
Back to library

Oscaro Search API

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.

Active2 credits = 1 requestGET/v2/oscaro/search
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Oscaro Search API returns auto parts listings from Oscaro shops (com, es, pt). Pass a keyword, a search URL, or a category listing URL (*-{id}-g), optionally with region and page, and receive structured JSON with prices and pagination.

Piloterr uses browser rendering and waits for article.productbox tiles before parsing the DOM.

Use each result url or product_id with Oscaro Product for full PDP data.

Supported regionsLink to Supported regions

Default: com (France via www.oscaro.com).

region Domain Search path Currency Aliases
com oscaro.com /fr/search?q=... EUR fr
es oscaro.es /es/search?q=... EUR
pt oscaro.pt /pt/search?q=... EUR

When query is a full Oscaro URL, region is detected from the TLD (region is ignored).

URL formatsLink to URL formats

Type Pattern Example
Search */search?q=* https://www.oscaro.com/fr/search?q=moteur+ai
Category listing *-{id}-g https://www.oscaro.com/huile-moteur-1862-g
Product (use Product API) *-{sku}-p https://www.oscaro.es/filtro-de-aceite-purflux-l343d-13644654-7-p

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/oscaro/search?query=moteur+ai
GET https://api.piloterr.com/v2/oscaro/search?query=moteur+ai&region=com
GET https://api.piloterr.com/v2/oscaro/search?query=https://www.oscaro.com/fr/search?q=moteur+ai
GET https://api.piloterr.com/v2/oscaro/search?query=https://www.oscaro.com/huile-moteur-1862-g&page=2

ParametersLink to Parameters

Parameter Type Required Description
query string yes Keyword, search URL, or category listing URL
region string no Shop when query is a keyword (default: com)
page integer no 1-based page override for category listings
return_page_source boolean no Raw HTML as {\"result\": \"...\"} (default: false)

Listings (results[])Link to Listings (results[])

Field Type Description
product_id string Slug id from product URL (e.g. 13361124-793)
title string Product title
url string Absolute product URL (-p suffix)
image_url string | null Card image
price number | null Displayed price
currency string ISO currency from shop config

PaginationLink to Pagination

Field Type Description
page integer Current page
per_page integer Results on this page (up to ~50 on keyword search)
total_results integer | null Often null
total_pages integer | null Set on category listings
next string | null Next page URL (?page=2 on listings; often null on keyword search)

Lazy-load placeholder tiles (.product-placeholder) are skipped.

Oscaro workflowLink to Oscaro workflow

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

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query / region
404 Page without parseable listings
500 Rendering or parsing error

NotesLink to Notes

  • Category listings paginate with query param page.
  • Keyword search (Algolia) returns up to ~50 results per page; pagination.next is often null.
  • Costs 2 credits per call (browser rendering).

Main use casesLink to Main use cases

  • Parts discovery: harvest product ids across keywords and categories
  • Price monitoring: track listing prices on search and category pages
  • Catalog crawl: walk category pagination via pagination.next

Related APIs

Expand your data capabilities with these complementary tools.

View All
Oscaro Product/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.

GET2 credits = 1 requestActive

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
Start free (+500 credits)PiloterrTalk to a data expert