# Oscaro Product Scraper (`sian.agency/oscaro-product-scraper`) Actor Scrape Oscaro car parts โ€” prices (EUR), brands, references, EAN, TecDoc specs, cross-references & images. Search by part name or OE reference, no vehicle selection. Clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/oscaro-product-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.70 / 1,000 overview products This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Oscaro Product Scraper โ€” Prices (EUR), References & Specs ๐Ÿ”ง [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![AutoZone Product Scraper](https://img.shields.io/badge/Store-AutoZone%20Scraper-E60000)](https://apify.com/sian.agency/autozone-product-scraper?fpr=sian) [![Advance Auto Parts Scraper](https://img.shields.io/badge/Store-Advance%20Auto%20Parts-F47B20)](https://apify.com/sian.agency/advance-auto-parts-product-scraper?fpr=sian) [![Google Shopping Price Tracker](https://img.shields.io/badge/Store-Google%20Shopping-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) #### ๐ŸŽ‰ Pull Oscaro car-parts prices, references, specs & cross-references โ€” by part name or OE reference, no code ##### Built for parts resellers, garages, price analysts, and data teams who need fresh Oscaro product data on demand --- ### ๐Ÿ“‹ Overview **Track every car-parts price, promotion, and specification on Oscaro โ€” without writing a single line of code, and without selecting a vehicle.** This scraper turns any Oscaro search โ€” a part name *or* an OE/manufacturer reference โ€” into a clean, structured spreadsheet of products complete with prices in EUR, brands, EAN barcodes, full TecDoc specifications, and equivalent (cross-reference) parts. **Why professionals choose us:** - โœ… **Complete parts data**: 30+ fields per product โ€” price (EUR), public price, promotions, brand, reference, EAN, category, images, availability and more - ๐Ÿ”Ž **Search without a vehicle**: type a part name (`plaquette de frein`) or a reference (`GDB1330`) โ€” no make/model/year selection needed - โšก **Fast search-first mode**: pull 100 products per page in seconds; scale to thousands across multiple searches - ๐Ÿ” **Cross-references built in**: every product lists its equivalent (OE/aftermarket) references for matching across catalogs - ๐Ÿ’Ž **Detail enrichment**: switch on the full TecDoc specifications table and the complete cross-reference list - ๐Ÿ’ฐ **Pay only for results**: charged per product you actually receive โ€” free tier to test --- ### โœจ Features - ๐Ÿ”Ž **Part-name & Reference Search**: search by a French part name or by any OE/manufacturer reference - ๐Ÿท๏ธ **Full Pricing (EUR)**: current price, pre-promo price, manufacturer public price (RRP), core deposit, VAT rate, promotion flag and percentage - โ„ข๏ธ **Brand & Identifiers**: manufacturer, reference, normalized reference, EAN/barcode and brand logo - ๐Ÿ“‹ **TecDoc Specifications**: full structured spec table (Detail mode) โ€” dimensions, material, technical attributes and more - ๐Ÿ” **Cross-references**: equivalent OE/aftermarket references grouped by manufacturer - ๐Ÿ—‚๏ธ **Categories**: top-level category and sub-category for clean classification - ๐Ÿš— **Fitment Insight**: a count of how many vehicle types each part fits, plus a universal-fit flag - ๐Ÿ–ผ๏ธ **Product Images**: product image URLs, ready for catalogs or feeds - ๐Ÿงฐ **Native Filters**: filter by brand, part type, in-stock, on-promotion or universal-fit - ๐Ÿ“ฆ **Clean Export**: results delivered as structured JSON or CSV, ready for Excel or your database - ๐Ÿš€ **No-Code Setup**: configure searches in a simple form โ€” no scripts, no maintenance --- ### ๐ŸŽฌ Quick Start Enter one or more search terms, pick a mode, and run. In under a minute you'll have a structured dataset of Oscaro products you can download as JSON or CSV. No setup, no code. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~oscaro-product-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"queries": ["plaquette de frein"], "scrapeMode": "overview"}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Add Your Searches Type one or more search terms โ€” a part name (`disque de frein`, `filtre ร  huile`, `amortisseur`) or an OE/manufacturer reference (`GDB1330`, `0986494027`) โ€” one per line. #### Step 2: Choose Your Mode Pick **Overview** for fast search results, or **Detail** to also pull the full TecDoc specifications table and every cross-reference. #### Step 3: Run & Download Click **Start**, then export your results as JSON, CSV, or Excel from the Apify dataset. *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Description | |---|---|---| | `queries` | array | Part names or OE/manufacturer references. One per line. e.g. `plaquette de frein`, `GDB1330` | | `scrapeMode` | enum | `overview` (fast) or `detail` (full specs + all cross-references) | | `brand` | string | Optional โ€” restrict to one manufacturer (e.g. `BOSCH`, `VALEO`, `BREMBO`) | | `genartId` | string | Optional (advanced) โ€” restrict to one TecDoc part-type id | | `available` | boolean | Optional โ€” only in-stock products | | `promo` | boolean | Optional โ€” only products on promotion | | `universal` | boolean | Optional โ€” only universal-fit parts | | `maxResults` | integer | Maximum products across all searches (FREE: 25 ยท PAID: unlimited) | Example input: ```json { "queries": ["plaquette de frein", "disque de frein"], "scrapeMode": "detail", "brand": "BOSCH", "available": true, "maxResults": 200 } ``` *** ### ๐Ÿ“ค Output Each product is one clean record. Example (overview): ```json { "item_id": "1780903", "productTitle": "Jeu de 4 plaquettes de frein", "brand": "BOSCH", "reference": "0 986 494 027", "ean": "4047024044036", "price": 22.9, "public_price": 74.89, "currency": "EUR", "available": true, "category": "Freinage", "sub_category": "Plaquettes de frein", "url": "https://www.oscaro.com/jeu-de-4-plaquettes-de-frein-bosch-0-986-494-027-1780903-402-p", "images": ["https://oscaro.media/oscjpg/normal/30/0986494027_1.jpg"], "equivalent_references": [{ "manufacturer": "TRUSTING", "references": ["3360"] }] } ``` In **Detail** mode each record additionally carries the full TecDoc `specs` table, every `equivalent_references` entry, and `vehicle_type_count`. *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price Monitoring Track Oscaro prices, public prices and promotions across the parts you sell โ€” in EUR, with VAT rate. #### 2. Cross-reference (OE) Lookup Resolve an OE or manufacturer reference to every equivalent aftermarket part and its price. #### 3. Catalog Building Build a clean parts catalog with brand, reference, EAN, category and images โ€” ready for a feed. #### 4. Competitive Analysis Compare Oscaro pricing and assortment by brand or part type against your own catalog. #### 5. Availability Research Filter to in-stock parts and monitor what is available across a category. #### 6. Market Research Survey which brands and part types dominate a category, and at what price points. *** ### ๐Ÿ”— Integration Examples #### JavaScript/Node.js ```javascript const res = await fetch('https://api.apify.com/v2/acts/sian.agency~oscaro-product-scraper/runs?token=YOUR_TOKEN', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ queries: ['plaquette de frein'], scrapeMode: 'overview' }), }); ``` #### Python ```python import requests requests.post( 'https://api.apify.com/v2/acts/sian.agency~oscaro-product-scraper/runs?token=YOUR_TOKEN', json={'queries': ['GDB1330'], 'scrapeMode': 'detail'}, ) ``` #### Automation Workflows (n8n / Zapier / Make) Trigger the actor on a schedule and pipe the dataset into Sheets, Airtable, or your database. *** ### ๐Ÿ“Š Performance & Pricing This actor uses **pay-per-event** pricing โ€” you pay for the products you receive, plus a small per-run base fee. #### FREE Tier (Try It Now) - Up to **25 products** per run - Both Overview and Detail modes - Full output fields #### PAID Tier (Production Ready) - **Unlimited** products per run - Sweep whole categories in a single run - Volume discounts at higher plan tiers The primary **Overview** event is the cheap, high-volume row; **Detail** is the premium row that adds the full specification table and every cross-reference. *** ### โ“ Frequently Asked Questions **Do I have to select a vehicle?** No. Search works directly by part name or reference โ€” no make/model/year is required. **Can I search by an OE or manufacturer reference?** Yes โ€” paste the reference (e.g. `GDB1330` or `0986494027`) as a query and you'll get the matching parts plus their cross-references. **What currency are prices in?** Euros (EUR), as shown on Oscaro's French store. **What's the difference between Overview and Detail?** Overview returns price, brand, reference, EAN, category, images, availability and the top cross-references. Detail adds the complete TecDoc specification table and every equivalent reference. **Which export formats are supported?** JSON, CSV, and Excel from the Apify dataset. *** ### ๐Ÿž Troubleshooting - **No results for a term** โ€” try the French part name (e.g. `plaquette de frein` rather than `brake pads`) or a precise reference. - **Too many results** โ€” add a `brand` or `genartId` filter, or lower `maxResults`. - **Want specs** โ€” switch `scrapeMode` to `detail`. *** ### โš–๏ธ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what is publicly shared. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### โš–๏ธ Trademark Disclaimer Oscaroยฎ is a trademark of Oscaro.com. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Oscaro.com. Brand names (e.g. BOSCH, VALEO, BREMBO) are trademarks of their respective owners and are used only to identify the parts they manufacture. *** ### โญ Love This Tool? If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/oscaro-product-scraper/reviews) โ€” it helps other professionals discover it and helps us keep improving. *** ### ๐Ÿค Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check the [SIรN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - ๐Ÿ“ง #### More from SIรN Agency - ๐Ÿš— [AutoZone Product Scraper](https://apify.com/sian.agency/autozone-product-scraper?fpr=sian) โ€” US auto-parts prices, specs & fitment - ๐Ÿ”ง [Advance Auto Parts Product Scraper](https://apify.com/sian.agency/advance-auto-parts-product-scraper?fpr=sian) โ€” US auto-parts catalog & pricing - ๐Ÿ›๏ธ [Google Shopping Price Tracker](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) โ€” track offers and price history across the web *** **Built by [SIรN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `queries` (type: `array`): ๐Ÿ” **SEARCH:** Free-text Oscaro searches โ€” a part name OR an OE/manufacturer reference, exactly what you'd type into the site's search bar. ๐Ÿ“ **EXAMPLES:** `plaquette de frein` (brake pads) ยท `disque de frein` (brake disc) ยท `filtre ร  huile` (oil filter) ยท `amortisseur` (shock absorber) ยท `GDB1330` (a manufacturer reference) ยท `0986494027` (an OE reference) ๐Ÿš— **NO VEHICLE NEEDED:** Search returns parts directly โ€” you don't have to select a make/model first. ๐Ÿ’ก **TIP:** Add one term per line โ€” each runs as its own search and all results land in the same dataset. ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many terms at once (one per line). ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search results only โ€” price (EUR), brand, reference, EAN, category, images, availability and the top cross-references. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (full specs):** Everything in Overview PLUS the complete TecDoc specifications table, every cross-reference (equivalent) brand and the vehicle-fitment count. ๐Ÿ’ก **TIP:** Start with Overview to scope a category, then switch to Detail when you need the complete spec sheet for feeds or comparisons. ## `brand` (type: `string`): โ„ข๏ธ **BRAND FILTER (optional):** Restrict results to a single manufacturer. ๐Ÿ“ **EXAMPLES:** `BOSCH` ยท `VALEO` ยท `BREMBO` ยท `DELPHI` ยท `FERODO` ยท `TRW` ๐Ÿ’ก **TIP:** Use the exact brand label as shown on Oscaro (UPPERCASE). Leave empty for all brands. ## `genartId` (type: `string`): ๐Ÿงฉ **PART-TYPE FILTER (Advanced):** Restrict results to a single TecDoc generic-article id (a precise part type, e.g. `402` = brake-pad set). ๐Ÿ”ง **HOW TO GET IT:** Run an Overview search first โ€” the `genart_id` field on each result is the value to paste here. ๐Ÿ’ก **TIP:** Leave empty unless you need to pin results to one exact part type. ## `available` (type: `boolean`): โœ… **AVAILABILITY FILTER (optional):** When enabled, returns only products currently in stock on Oscaro. ๐Ÿ’ก **TIP:** Leave off to include out-of-stock items in the results. ## `promo` (type: `boolean`): ๐Ÿ”ฅ **PROMOTION FILTER (optional):** When enabled, returns only products currently on promotion (discounted). ๐Ÿ’ก **TIP:** Leave off to include full-price items. ## `universal` (type: `boolean`): ๐ŸŒ **FITMENT FILTER (optional):** When enabled, returns only universal parts (fit any vehicle). ๐Ÿ’ก **TIP:** Leave off to include vehicle-specific parts (the vast majority). ## `maxResults` (type: `integer`): ๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all search terms combined. ๐ŸŽ **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited โ€” scrape entire categories in a single run ๐Ÿ’ก **TIP:** Keep this low while you dial in your search terms, then raise it once the output looks right. ## Actor input object example ```json { "queries": [ "plaquette de frein" ], "scrapeMode": "overview", "available": false, "promo": false, "universal": false, "maxResults": 100 } ``` # Actor output Schema ## `oscaroProducts` (type: `string`): Scraped Oscaro car parts with prices, promotions, references, specs, cross-references and images. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "plaquette de frein" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/oscaro-product-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["plaquette de frein"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/oscaro-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "plaquette de frein" ] }' | apify call sian.agency/oscaro-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/oscaro-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Oscaro Product Scraper", "description": "Scrape Oscaro car parts โ€” prices (EUR), brands, references, EAN, TecDoc specs, cross-references & images. Search by part name or OE reference, no vehicle selection. Clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "Twjjqz3u0u5q46eJZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~oscaro-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-oscaro-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~oscaro-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-oscaro-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~oscaro-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-oscaro-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "queries": { "title": "๐Ÿ” Search Terms / References", "type": "array", "description": "๐Ÿ” **SEARCH:** Free-text Oscaro searches โ€” a part name OR an OE/manufacturer reference, exactly what you'd type into the site's search bar.\n\n๐Ÿ“ **EXAMPLES:** `plaquette de frein` (brake pads) ยท `disque de frein` (brake disc) ยท `filtre ร  huile` (oil filter) ยท `amortisseur` (shock absorber) ยท `GDB1330` (a manufacturer reference) ยท `0986494027` (an OE reference)\n\n๐Ÿš— **NO VEHICLE NEEDED:** Search returns parts directly โ€” you don't have to select a make/model first.\n\n๐Ÿ’ก **TIP:** Add one term per line โ€” each runs as its own search and all results land in the same dataset.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many terms at once (one per line).", "default": [ "plaquette de frein" ], "items": { "type": "string" } }, "scrapeMode": { "title": "โš™๏ธ Scrape Mode", "enum": [ "overview", "detail" ], "type": "string", "description": "โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\nโšก **Overview (fast):** Search results only โ€” price (EUR), brand, reference, EAN, category, images, availability and the top cross-references. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (full specs):** Everything in Overview PLUS the complete TecDoc specifications table, every cross-reference (equivalent) brand and the vehicle-fitment count.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope a category, then switch to Detail when you need the complete spec sheet for feeds or comparisons.", "default": "overview" }, "brand": { "title": "โ„ข๏ธ Brand Filter", "type": "string", "description": "โ„ข๏ธ **BRAND FILTER (optional):** Restrict results to a single manufacturer.\n\n๐Ÿ“ **EXAMPLES:** `BOSCH` ยท `VALEO` ยท `BREMBO` ยท `DELPHI` ยท `FERODO` ยท `TRW`\n\n๐Ÿ’ก **TIP:** Use the exact brand label as shown on Oscaro (UPPERCASE). Leave empty for all brands." }, "genartId": { "title": "๐Ÿงฉ Part-Type ID (Advanced)", "type": "string", "description": "๐Ÿงฉ **PART-TYPE FILTER (Advanced):** Restrict results to a single TecDoc generic-article id (a precise part type, e.g. `402` = brake-pad set).\n\n๐Ÿ”ง **HOW TO GET IT:** Run an Overview search first โ€” the `genart_id` field on each result is the value to paste here.\n\n๐Ÿ’ก **TIP:** Leave empty unless you need to pin results to one exact part type." }, "available": { "title": "โœ… In Stock Only", "type": "boolean", "description": "โœ… **AVAILABILITY FILTER (optional):** When enabled, returns only products currently in stock on Oscaro.\n\n๐Ÿ’ก **TIP:** Leave off to include out-of-stock items in the results.", "default": false }, "promo": { "title": "๐Ÿ”ฅ On Promotion Only", "type": "boolean", "description": "๐Ÿ”ฅ **PROMOTION FILTER (optional):** When enabled, returns only products currently on promotion (discounted).\n\n๐Ÿ’ก **TIP:** Leave off to include full-price items.", "default": false }, "universal": { "title": "๐ŸŒ Universal-Fit Only", "type": "boolean", "description": "๐ŸŒ **FITMENT FILTER (optional):** When enabled, returns only universal parts (fit any vehicle).\n\n๐Ÿ’ก **TIP:** Leave off to include vehicle-specific parts (the vast majority).", "default": false }, "maxResults": { "title": "๐Ÿ”ข Max Results", "minimum": 1, "type": "integer", "description": "๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all search terms combined.\n\n๐ŸŽ **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited โ€” scrape entire categories in a single run\n\n๐Ÿ’ก **TIP:** Keep this low while you dial in your search terms, then raise it once the output looks right.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```