# OfferUp Used Cars, Vehicles & VIN Scraper: Dealer Specs 🚗 (`unitbytes/offerup-vehicles-cars-scraper`) Actor

Extract OfferUp used cars, trucks, VIN numbers, mileage, title status, MPG, history report issues, and auto dealer phone numbers by make, model, year & ZIP code. From $0.80/1k.

- **URL**: https://apify.com/unitbytes/offerup-vehicles-cars-scraper.md
- **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 listing discoveries

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🚗 OfferUp Used Cars, Vehicles & VIN Scraper — 19 Auto Specs, History Reports & Dealer Contacts

<p align="center">
  <a href="https://console.apify.com/actors/0EHLVn9sWGx5iM3uc?addFromActorId=0EHLVn9sWGx5iM3uc" target="_blank">
    <img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
  <br>
  <sub>⚡ <b>1-Click Free Trial:</b> Test live queries using Apify's free monthly credit • No credit card required</sub>
</p>

Extract **OfferUp used cars, trucks, motorcycles, and auto parts** across any US ZIP code in seconds. Purpose-built for **used car dealerships, auto wholesalers, car flippers, and automotive market intelligence** — capturing **17-digit VINs, odometer mileage, title status (Clean/Salvage), drivetrain, engine specs, MPG, AutoCheck/Carfax history report issue counts, and dealer phone numbers & addresses**.

- 🔢 **19 Structured Vehicle Attributes** — `vehicleVin`, `vehicleYear`, `vehicleMake`, `vehicleModel`, `vehicleTrim`, `vehicleMiles`, `vehicleTitleStatus`, `vehicleDriveTrain` (`FWD`/`RWD`/`AWD`/`4WD`), `vehicleTransmission`, `vehicleEngineCylinders`, `vehicleEngineDescription`, `vehicleCityMpg`, `vehicleHighwayMpg`, `vehicleColor`, `vehicleDoors`, `vehicleBody`, `vehicleFuelType`, `vehicleStockNumber`, and `vehicleOptions`.
- 📋 **Vehicle History Report Intelligence** — extracts `vehicleHistoryProvider` (`AutoCheck` / `Carfax`), `vehicleHistoryIssues` (issue count), and `vehicleHistoryReportUrl`.
- 📞 **Dealer vs. Private Seller Lead Capture** — distinguishes `isAutosDealer` (`vehicleSellerType: "dealer"`) from private owners and extracts **verified dealership phone numbers (`sellerPhone`), website links (`sellerWebsite`), physical addresses (`sellerAddress`), business hours (`sellerOpeningHours`), and Google Reviews**.
- ⚡ **Server-Side Year & Mileage Filtering** — filter upstream by `make`, `model`, `minYear`, `maxYear`, `maxMiles`, `minPrice`, and `maxPrice` so you only pay for matching vehicles.

***

<table>
  <tr>
    <td colspan="3" style="padding:10px 14px;background:#2563EB;color:#FFFFFF;font-size:13px;font-weight:700;border-radius:6px 6px 0 0">
      ⚡ UnitBytes · Local Marketplaces, Vehicles, Real Estate & Classifieds Ecosystem
    </td>
  </tr>
  <tr>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">📱 <b><a href="https://apify.com/unitbytes/offerup-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">OfferUp All-in-One</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Local Deals, Motors & Shipping</span><br>
      <span style="color:#64748B;font-size:11px">ZIP radius, 19 vehicle specs, seller leads & price drops</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">🏷️ <b><a href="https://apify.com/unitbytes/craigslist-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">Craigslist All-in-One</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">700+ Cities · All Categories</span><br>
      <span style="color:#64748B;font-size:11px">Cars, housing, jobs, for sale, phones & emails</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">🛒 <b><a href="https://apify.com/unitbytes/Facebook-Marketplace-Scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">FB Marketplace All-in-One</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Cars, Rentals & Local Items</span><br>
      <span style="color:#64748B;font-size:11px">50+ fields, seller profiles, HD photos & bypass 1K limit</span>
    </td>
  </tr>
  <tr>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FFF4ED;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">🚙 <b><a href="https://apify.com/unitbytes/offerup-vehicles-cars-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#C2410C;text-decoration:none;font-size:13px">OfferUp Used Cars & VIN</a></b></span><br><span style="color:#EA580C;font-size:11px;font-weight:700">📍 You are here</span><br>
      <span style="color:#64748B;font-size:11px">VIN, MPG, drivetrain & Carfax/AutoCheck issue counts</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">🚗 <b><a href="https://apify.com/unitbytes/craigslist-cars-vehicles-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">Craigslist Cars & Vehicles</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">By Owner (CTO), VIN & Miles</span><br>
      <span style="color:#64748B;font-size:11px">17-digit VIN, clean title, RVs, boats & motorcycles</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">🏎️ <b><a href="https://apify.com/unitbytes/facebook-marketplace-vehicle-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">FB Marketplace Vehicles</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Cars, Trucks & Motorcycles</span><br>
      <span style="color:#64748B;font-size:11px">Filter by make, model, year, odometer mileage & VIN</span>
    </td>
  </tr>
  <tr>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">🏪 <b><a href="https://apify.com/unitbytes/offerup-seller-inventory-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">OfferUp Seller & Dealer Leads</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Storefronts & B2B Contacts</span><br>
      <span style="color:#64748B;font-size:11px">Full /p/&lt;userId&gt; catalog, dealer phones, address & reviews</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">⚡ <b><a href="https://apify.com/unitbytes/offerup-deal-monitor-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">OfferUp Deal & Price Monitor</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Price Drops & Status Tracker</span><br>
      <span style="color:#64748B;font-size:11px">Fresh bargains, % price drops & batch LISTED/SOLD check</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:33.3%">
      <span style="white-space:nowrap">🔍 <b><a href="https://apify.com/unitbytes/facebook-marketplace-status-checker?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">FB Marketplace Status Checker</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Sold, Pending & Price Audit</span><br>
      <span style="color:#64748B;font-size:11px">Bulk check ACTIVE/SOLD/PENDING status & seller catalogs</span>
    </td>
  </tr>
</table>

***

### 💰 Transparent Pay-Per-Event (PPE) Pricing

| Event / Mode | Free Tier | Bronze Plan | Silver Plan | Gold & Enterprise | What's Included |
| :--- | :---: | :---: | :---: | :---: | :--- |
| **Vehicle Discovery (`listing`)** | **$0.80 / 1k** | **$0.73 / 1k** | **$0.67 / 1k** | **$0.60 / 1k** | Title, Price, Mileage (`vehicleMiles`), Location, Thumbnail, Listing URL |
| **Full VIN & Dealer Enrichment (`detail`)** | **$2.50 / 1k** | **$2.25 / 1k** | **$2.00 / 1k** | **$1.80 / 1k** | 17-Digit VIN, 19 Auto Specs, History Report Issues, Dealer Phone/Address/Hours, Full HD Photos |
| **Server Compute & RAM** | **$0.00** | **$0.00** | **$0.00** | **$0.00** | 100% FREE (256MB lightweight container) |

***

### 📤 Sample Output Record (Used Car with VIN & Dealer Info)

```json
{
  "listingId": "31e89a78-c823-3e02-89b3-8b15e2380f28",
  "url": "https://offerup.com/item/detail/31e89a78-c823-3e02-89b3-8b15e2380f28",
  "title": "2022 Honda Civic Si",
  "price": 18995.0,
  "status": "LISTED",
  "categoryName": "Vehicles",
  "subcategoryName": "Cars & Trucks",
  "locationName": "Houston, TX",
  "latitude": 29.7301,
  "longitude": -95.6432,
  "isVehicle": true,
  "vehicleYear": 2022,
  "vehicleMake": "Honda",
  "vehicleModel": "Civic Si",
  "vehicleTrim": "Si",
  "vehicleMiles": 70408,
  "vehicleVin": "2HGFE1E56NH471015",
  "vehicleColor": "red",
  "vehicleBody": "Sedan",
  "vehicleDoors": 4,
  "vehicleTransmission": "Manual",
  "vehicleDriveTrain": "FWD",
  "vehicleFuelType": "Premium gasoline",
  "vehicleEngineCylinders": "4",
  "vehicleEngineDescription": "1.5L I-4 direct injection, DOHC, VTEC variable valve control, intercooled turbo, 200HP",
  "vehicleCityMpg": 27,
  "vehicleHighwayMpg": 37,
  "vehicleStockNumber": "CN1015",
  "vehicleSellerType": "dealer",
  "vehicleOptions": [
    "Backup Camera",
    "LED Headlights",
    "Lane Keeping Assist",
    "Push Button Ignition"
  ],
  "sellerId": "170778807",
  "sellerProfileUrl": "https://offerup.com/p/170778807",
  "sellerName": "Crown Auto Sales 2",
  "sellerPhone": "8329604446",
  "sellerWebsite": "https://crownautosalestx.com/aboutus",
  "sellerAddress": "2737 S Texas 6, Houston, TX 77082, USA",
  "isDealer": true,
  "isAutosDealer": true,
  "sellerBadges": [
    "Confirmed phone",
    "Confirmed email"
  ],
  "sellerGoogleReviewRating": 4.0
}
```

***

### 🔌 MCP Server Setup: Claude Code, Cursor & AI Agents

```json
{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=actors,docs,unitbytes/offerup-vehicles-cars-scraper"
    }
  }
}
```

***

### 🌐 Related UnitBytes Automotive & Marketplace Scrapers

- 📱 **[OfferUp All-in-One Marketplace Scraper](https://apify.com/unitbytes/offerup-scraper?fpr=939u3w\&fp_sid=ecosystem)** — Local deals, nationwide shipping, vehicles, seller profiles & price drops.
- 🏪 **[OfferUp Seller Inventory & Auto Dealer Leads Scraper](https://apify.com/unitbytes/offerup-seller-inventory-scraper?fpr=939u3w\&fp_sid=ecosystem)** — Extract complete `/p/<userId>` storefronts, verified dealer phone numbers, addresses & Google reviews.
- ⚡ **[OfferUp Deal Monitor, Price Drop & Status Tracker](https://apify.com/unitbytes/offerup-deal-monitor-scraper?fpr=939u3w\&fp_sid=ecosystem)** — Real-time bargain alerts, `%` price drops & batch `LISTED`/`SOLD` status verification.
- 🚗 **[Craigslist Cars, Trucks & Vehicles Scraper](https://apify.com/unitbytes/craigslist-cars-vehicles-scraper?fpr=939u3w\&fp_sid=ecosystem)** & **[Craigslist All-in-One](https://apify.com/unitbytes/craigslist-scraper?fpr=939u3w\&fp_sid=ecosystem)** — By-owner (`cto`) vehicles, 17-digit VINs, mileage & direct phone/email leads across 700+ cities.
- 🏎️ **[Facebook Marketplace Vehicle Scraper](https://apify.com/unitbytes/facebook-marketplace-vehicle-scraper?fpr=939u3w\&fp_sid=ecosystem)** & **[FB Marketplace All-in-One](https://apify.com/unitbytes/Facebook-Marketplace-Scraper?fpr=939u3w\&fp_sid=ecosystem)** — Used cars, VINs, odometer mileage & **[FB Status Checker](https://apify.com/unitbytes/facebook-marketplace-status-checker?fpr=939u3w\&fp_sid=ecosystem)**.
- 📍 **[Google Maps Reviews Tracker](https://apify.com/unitbytes/google-maps-reviews-tracker?fpr=939u3w\&fp_sid=ecosystem)** — Audit dealership reputation and track customer reviews.

***

### 💬 Support & Feedback

- 💬 Open a ticket in the [Apify Issues Tab](https://apify.com/unitbytes/offerup-vehicles-cars-scraper/issues) or email `contact@unitbytes.com`.

# Changelog

This Actor's version history is a separate document: https://apify.com/unitbytes/offerup-vehicles-cars-scraper/changelog.md

# Actor input Schema

## `make` (type: `string`):

Vehicle manufacturer (e.g., 'Honda', 'Toyota', 'Ford', 'BMW', 'Chevrolet').

## `model` (type: `string`):

Vehicle model (e.g., 'Civic', 'Camry', 'F-150', 'Tacoma').

## `searchQuery` (type: `string`):

Optional extra search keywords (e.g., 'Si', 'hybrid', 'clean title', 'AWD').

## `categoryId` (type: `string`):

OfferUp automotive category.

## `minYear` (type: `integer`):

Server-side filter for minimum model year (e.g. 2018).

## `maxYear` (type: `integer`):

Server-side filter for maximum model year (e.g. 2026).

## `maxMiles` (type: `integer`):

Server-side filter for maximum odometer mileage (OfferUp uses 25,000-mile increments: 25000, 50000, 75000, 100000, 125000, 150000, 175000, 200000).

## `minPrice` (type: `integer`):

Minimum vehicle price in USD.

## `maxPrice` (type: `integer`):

Maximum vehicle price in USD.

## `zipCode` (type: `string`):

5-digit US ZIP code (e.g. 90001 for Los Angeles, 77082 for Houston, 33101 for Miami).

## `radius` (type: `integer`):

Search distance radius around the ZIP code (5 to 500 miles).

## `sortBy` (type: `string`):

Sorting order for vehicle listings.

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

Maximum number of vehicle listings to extract.

## `scrapeDetails` (type: `boolean`):

When enabled (default), extracts full 17-character VIN, title status, drivetrain, cylinders, MPG, vehicle options, history report issues, and dealer phone/address ($2.50/1k). Disable for fast summary discovery ($0.80/1k).

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

OfferUp vehicle search, dealer profile (/p/<userId>), or direct car listing URLs.

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

Apify Residential US proxy configuration.

## Actor input object example

```json
{
  "make": "Honda",
  "model": "Civic",
  "categoryId": "5.1",
  "zipCode": "90001",
  "radius": 50,
  "sortBy": "-posted",
  "maxItems": 20,
  "scrapeDetails": true,
  "startUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Extracted used cars, VINs, mileage, title status, drivetrain, MPG, history report issues, and dealer contact details.

# 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 = {
    "make": "Honda",
    "model": "Civic",
    "zipCode": "90001",
    "startUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

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

# Prepare the Actor input
run_input = {
    "make": "Honda",
    "model": "Civic",
    "zipCode": "90001",
    "startUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("unitbytes/offerup-vehicles-cars-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "make": "Honda",
  "model": "Civic",
  "zipCode": "90001",
  "startUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call unitbytes/offerup-vehicles-cars-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/offerup-vehicles-cars-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0EHLVn9sWGx5iM3uc/builds/VmjOL3cyXJexi2eOc/openapi.json
