# OReillyAuto.com Scraper (`lexis-solutions/oreillyauto`) Actor

Scrape product data from OReillyAuto.com - including part names, SKUs, prices, availability, compatibility info, and images. Ideal for market research, price monitoring, and inventory analytics. Fast, structured, and customizable extraction.

- **URL**: https://apify.com/lexis-solutions/oreillyauto.md
- **Developed by:** [Lexis Solutions](https://apify.com/lexis-solutions) (community)
- **Categories:** E-commerce, Developer tools, Automation
- **Stats:** 31 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

$29.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## 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

## 🛠️ O’Reilly Auto Scraper

![O'Reilly Auto Scraper](https://i.ibb.co/sJpTK9qb/oreillyauto-cover.png)

This actor is designed to scrape product listings and detailed item pages from OReillyAuto.com, one of the largest auto parts retailers in the U.S. Whether you're targeting search result pages, category listings, or individual product detail pages, this scraper extracts structured product information like title, brand, pricing, and specifications.

---

### 🚀 Key Features

- ✅ Extracts products from **search pages**, **categories**, and **direct product URLs**
- ✅ Retrieves **dynamic price data**, availability, brand, and fitment info
- ✅ Supports multiple start URLs (search queries, categories, or item pages)
- ✅ Full proxy support for stable and geo-aware scraping

---

### 👤 Who Is This Actor For?

This actor is perfect for:

- 🔧 **Auto part resellers** tracking market prices and availability
- 🧾 **eCommerce analysts** building databases of SKU information
- 🔍 **SEO professionals** researching content structure and metadata
- 🔄 **Price aggregators** collecting comparable offers
- 📦 **Inventory planners** validating brand and stock listings programmatically

---

### ❓ Why Is This Actor Important?

O’Reilly Auto Parts sells a massive catalog of vehicle parts and tools. Much of its data — such as dynamic pricing and real-time availability — is rendered on the client side and not easily accessible via simple HTTP requests. This actor:

- Extracts clean and structured data from **various entry points** (search/category/product)
- Saves you hours of manual data collection or reverse-engineering

---

### Tech Notes

- It is recommended to set the actor memory to at least 4GB to avoid performance issues.

---

### Input Schema

Here’s an example input you can pass to the actor:

```json
{
  "startUrls": [
    {
      "url": "https://www.oreillyauto.com/search?q=Slime+Chome&page=3"
    },
    {
      "url": "https://www.oreillyauto.com/shop/b/air-conditioning---heating/blend-door/e500a52c2f93"
    },
    {
      "url": "https://www.oreillyauto.com/detail/c/slime/slime-inner-tubes/sli0/30011"
    }
  ],
  "query": "Conductor",
  "enrich": true,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
````

#### `enrich` behavior

- **`enrich: false` (default)**: Scrapes **listing/search/category pages only** and outputs the data available there (title, price, image, basic specs shown in the listing). It **does not open product detail pages**, so fields like `description`, `brandInformation`, and full `images` will typically be `null` / empty.
- **`enrich: true`**: After collecting listing items, the actor **enqueues and visits each product detail page** and outputs the **fully enriched product object** (description, brand info, additional images/specs, etc.). This is **slower** and more likely to hit anti-bot protections without proxies, but gives the richest output.

### Output Schema

#### Example output (`enrich: false`)

```json
{
  "id": "716281000942",
  "mpn": "30011",
  "sku": null,
  "title": "Slime Inner Tubes",
  "url": "https://www.oreillyauto.com/detail/c/slime/slime-inner-tubes/sli0/30011",
  "type": "Product",
  "brand": null,
  "brandInformation": null,
  "price": 20.99,
  "manufacturer": null,
  "primaryImageUrl": "https://images.oreillyauto.com/parts/img/extralarge/sli/30011_front.jpg",
  "description": null,
  "descriptionHTML": null,
  "images": [
    "https://images.oreillyauto.com/parts/img/extralarge/sli/30011_front.jpg",
    null
  ],
  "line": "SLI",
  "specs": [
    { "key": "Material", "value": "Rubber" }
  ]
}
```

#### Example output (`enrich: true`)

```json
{
  "id": "716281000942",
  "mpn": "30011",
  "sku": "716281000942",
  "title": "Slime Inner Tubes",
  "description": "Upgrade from an inner tube to a Smart Tube and enjoy two years of flat tire protection. Smart Tube: An inner tube with Slime Inside. Seeks out and seals punctures up to 1/8 Inch. 6 Inch. Backed by the Slime Satisfaction Guarantee.",
  "descriptionHTML": "Tire Tube; 6 Inch; <p>Upgrade from an inner tube to a Smart Tube and enjoy two years of flat tire protection. Smart Tube: An inner tube with Slime Inside. Seeks out and seals punctures up to 1/8 Inch. 6 Inch. Backed by the Slime Satisfaction Guarantee.<\\/p>",
  "url": "https://www.oreillyauto.com/detail/c/slime/slime-inner-tubes/sli0/30011",
  "type": "Product",
  "brand": "Slime",
  "brandInformation": "The first bottles of Slime tire sealant were blended by hand with a power drill and a drywall blade in a garage on the Central Coast of California...",
  "price": 20.99,
  "manufacturer": "Slime",
  "primaryImageUrl": "https://images.oreillyauto.com/parts/img/extralarge/sli/30011_front.jpg",
  "images": [
    "https://images.oreillyauto.com/parts/img/extralarge/sli/30011_front.jpg",
    "https://images.oreillyauto.com/parts/img/extralarge/sli/30011_back.jpg"
  ],
  "line": "SLI",
  "specs": [
    { "key": "Material", "value": "Rubber" },
    { "key": "Rim Diameter (in)", "value": "6 Inch" }
  ]
}
```

***

👀 p.s.

Got feedback or need an extension?

Lexis Solutions is a [certified Apify Partner](https://apify.com/partners/find). We can help you with custom solutions or data extraction projects.

Contact us over [Email](mailto:scraping@lexis.solutions) or [LinkedIn](https://www.linkedin.com/company/lexis-solutions)

### Support Our Work 💝

If you're happy with our work and scrapers, you're welcome to leave us a company review [here](https://apify.com/partners/find/lexis-solutions/review) and leave a review for the scrapers you're subscribed to. It will take you less than a minute but it will mean a lot to us!

Image Credit: OReillyAuto.com

# Actor input Schema

## `startUrls` (type: `array`):

URLs to scrape

## `query` (type: `string`):

Query to search for products in OreillyAuto

## `enrich` (type: `boolean`):

Whether to enrich the detail page with additional information. Will slow down the scraping process.

## `maxItems` (type: `integer`):

The maximum number of items to fetch

## `proxyConfiguration` (type: `object`):

Your proxy configuration from Apify

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.oreillyauto.com/search?q=conductor"
    }
  ],
  "query": "Conductor",
  "enrich": false,
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.oreillyauto.com/search?q=conductor"
        }
    ],
    "query": "Conductor",
    "enrich": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("lexis-solutions/oreillyauto").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.oreillyauto.com/search?q=conductor" }],
    "query": "Conductor",
    "enrich": False,
}

# Run the Actor and wait for it to finish
run = client.actor("lexis-solutions/oreillyauto").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 '{
  "startUrls": [
    {
      "url": "https://www.oreillyauto.com/search?q=conductor"
    }
  ],
  "query": "Conductor",
  "enrich": false
}' |
apify call lexis-solutions/oreillyauto --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lexis-solutions/oreillyauto",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "OReillyAuto.com Scraper",
        "description": "Scrape product data from OReillyAuto.com - including part names, SKUs, prices, availability, compatibility info, and images. Ideal for market research, price monitoring, and inventory analytics. Fast, structured, and customizable extraction.",
        "version": "0.1",
        "x-build-id": "bAxVIIxYho1fFCPbW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/lexis-solutions~oreillyauto/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-lexis-solutions-oreillyauto",
                "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/lexis-solutions~oreillyauto/runs": {
            "post": {
                "operationId": "runs-sync-lexis-solutions-oreillyauto",
                "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/lexis-solutions~oreillyauto/run-sync": {
            "post": {
                "operationId": "run-sync-lexis-solutions-oreillyauto",
                "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": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "URLs to scrape",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "query": {
                        "title": "Query",
                        "type": "string",
                        "description": "Query to search for products in OreillyAuto"
                    },
                    "enrich": {
                        "title": "Enrich Detail",
                        "type": "boolean",
                        "description": "Whether to enrich the detail page with additional information. Will slow down the scraping process.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Max items",
                        "type": "integer",
                        "description": "The maximum number of items to fetch",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Your proxy configuration from Apify",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "US"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
