auto-dev

Category: Development & Coding | Uploader: drivly | Downloads: 0 | Version: v1.0（Latest）

Use when working with Auto.dev APIs, vehicle data, VIN decoding, car listings, vehicle photos, specs, recalls, payments, interest rates, taxes, OEM build data, plate-to-VIN, or any automotive data API calls

Changelog: Source: GitHub https://github.com/drivly/auto-dev-skill

Directory Structure

Current level: Root

📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.md 702 B
  - 📄 feature_request.md 642 B
- 📄 FUNDING.yml 15 B
📁 assets/
- 📄 autodev.png 3.2 MB
📄 .gitignore 474 B
📄 app-scaffolding.md 8.6 KB
📄 business-workflows.md 7.7 KB
📄 chaining-patterns.md 4.2 KB
📄 code-patterns.md 16.3 KB
📄 CODE_OF_CONDUCT.md 2.1 KB
📄 CONTRIBUTING.md 2.8 KB
📄 error-recovery.md 4.9 KB
📄 examples.md 9.6 KB
📄 integration-recipes.md 11.4 KB
📄 interactive-explorer.md 4.2 KB
📄 LICENSE 1.0 KB
📄 pricing.md 4.2 KB
📄 README.md 8.3 KB
📄 SKILL.md 4.9 KB
📄 v1-apis.md 4.1 KB
📄 v2-listings-api.md 3.3 KB
📄 v2-plate-api.md 1.1 KB
📄 v2-vin-apis.md 8.3 KB

SKILL.md

---
name: auto-dev
description: Use when working with Auto.dev APIs, vehicle data, VIN decoding, car listings, vehicle photos, specs, recalls, payments, interest rates, taxes, OEM build data, plate-to-VIN, or any automotive data API calls
version: 1.0.2
tags:
  - automotive
  - vehicle-data
  - vin
  - listings
  - api
  - auto-dev
  - car-search
  - recalls
homepage: https://github.com/drivly/auto-dev-skill
metadata:
  openclaw:
    requires:
      env:
        - AUTODEV_API_KEY
    primaryEnv: AUTODEV_API_KEY
---

# Auto.dev API

V2 is the primary API. V1 provides supplemental endpoints with no V2 equivalent.

## Authentication

Check for `AUTODEV_API_KEY` environment variable first. If not set, ask: "Do you have an Auto.dev API key?"

- **If yes:** Ask them to paste it or set it with `export AUTODEV_API_KEY="your-key-here"`
- **If no:** Direct them to https://www.auto.dev/pricing to sign up (free Starter plan available)

**V2** (base: `https://api.auto.dev`): `Authorization: Bearer {key}` or `?apiKey={key}`
**V1** (base: `https://auto.dev/api`): `?apikey={key}` (query string only)

## API Reference — Copy These URLs

Use these exact URL patterns. Do NOT guess parameter names — wrong params return 400.

**Search Listings** (Starter)
```
GET https://api.auto.dev/listings?vehicle.make=Audi&vehicle.model=R8&retailListing.price=1-60000&retailListing.state=FL&limit=100&page=1&apiKey={key}
```
More filters: `vehicle.year=2022-2024`, `vehicle.bodyStyle=SUV`, `vehicle.drivetrain=AWD`, `retailListing.miles=1-50000`, `zip=33132&distance=50`. See v2-listings-api.md for all filters.

**Single Listing** (Starter)
```
GET https://api.auto.dev/listings/{vin}?apiKey={key}
```

**VIN Decode** (Starter)
```
GET https://api.auto.dev/vin/{vin}?apiKey={key}
```

**Vehicle Photos** (Starter)
```
GET https://api.auto.dev/photos/{vin}?apiKey={key}
```

**Specifications** (Growth)
```
GET https://api.auto.dev/specs/{vin}?apiKey={key}
```

**OEM Build Data** (Growth — $0.10/call)
```
GET https://api.auto.dev/build/{vin}?apiKey={key}
```

**Vehicle Recalls** (Growth)
```
GET https://api.auto.dev/recalls/{vin}?apiKey={key}
```

**Total Cost of Ownership** (Growth)
```
GET https://api.auto.dev/tco/{vin}?zip=33132&apiKey={key}
```

**Vehicle Payments** (Growth) — `price` and `zip` are required
```
GET https://api.auto.dev/payments/{vin}?price=39520&zip=33132&downPayment=5000&loanTerm=60&apiKey={key}
```

**Interest Rates** (Growth) — `year`, `make`, `model`, `zip`, `creditScore` are required
```
GET https://api.auto.dev/apr/{vin}?year=2024&make=Audi&model=R8&zip=33132&creditScore=720&apiKey={key}
```

**Open Recalls** (Scale)
```
GET https://api.auto.dev/openrecalls/{vin}?apiKey={key}
```

**Plate-to-VIN** (Scale — $0.55/call)
```
GET https://api.auto.dev/plate/{state}/{plate}?apiKey={key}
```

**Taxes & Fees** (Scale) — `price` and `zip` are required
```
GET https://api.auto.dev/taxes/{vin}?price=39520&zip=33132&apiKey={key}
```

### V1 Supplemental (No V2 Equivalent)

```
GET https://auto.dev/api/models?apikey={key}
GET https://auto.dev/api/cities?apikey={key}
GET https://auto.dev/api/zip/{zip}?apikey={key}
GET https://auto.dev/api/autosuggest/{term}?apikey={key}
```

### Parameters That Do NOT Exist (Will Return 400)

```
make=          ← use vehicle.make
model=         ← use vehicle.model
_order=        ← no sort parameter exists
sort=          ← no sort parameter exists
rows=          ← use limit
state=         ← use retailListing.state
price=         ← use retailListing.price (on /listings), or price= (on /payments, /taxes)
```

## Plans & Pricing

See pricing.md for full per-call costs and upgrade links.

| Plan | Monthly | Includes |
|------|---------|----------|
| Starter | Free + data fees | VIN Decode, Listings, Photos (1,000 free calls/mo) |
| Growth | $299/mo + data fees | + Specs, Recalls, TCO, Payments, APR, Build |
| Scale | $599/mo + data fees | + Open Recalls, Plate-to-VIN, Taxes & Fees |

All plans charge per-call data fees on every request. Growth/Scale have no cap on volume but data fees still apply.

## Important Rules

- **Before batch operations**, call the endpoint once with a single item to see the actual response shape. Do not guess field names or nesting — inspect the real response first.
- **Include ALL fields** from the API response unless the user explicitly says to exclude some.
- **Small results** (<10 items, single VIN): Display inline as formatted table
- **Large results** (10+ listings): Ask user preference, default to CSV export
- **Always support**: CSV, JSON export when user requests
- **Chain APIs** when the query spans multiple endpoints

## Deep Reference

**API Docs:** v2-listings-api.md | v2-vin-apis.md | v2-plate-api.md | v1-apis.md
**Workflows:** chaining-patterns.md | interactive-explorer.md | business-workflows.md
**Code Gen:** code-patterns.md | app-scaffolding.md | integration-recipes.md
**Other:** error-recovery.md | pricing.md | examples.md

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

auto-dev

Directory Structure

SKILL.md

Report

Notice