# Tractordata — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and explore detailed tractor information including specifications, engine and transmission data, dimensions, photos, and attachments across farm and lawn tractor brands and models. Stay updated with the latest tractor news, industry shows, and test results all in one place.

**Category:** Automotive | **Website:** [tractordata.com/](https://tractordata.com/) | **Docs:** [parse.bot/marketplace/7a7067e9-5933-4a6d-80c7-d0aab38c5530/tractordata-com-api](https://parse.bot/marketplace/7a7067e9-5933-4a6d-80c7-d0aab38c5530/tractordata-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get articles news

List tractor-related articles, technical resources, book reviews, and news from TractorData.com. Returns article titles and relative page paths. No pagination; returns the complete list.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-articles-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get brand models

List all tractor models for a given brand slug. Returns model name, relative page path, numeric ID, power rating, and year range for each model. The path field can be passed directly to detail endpoints (get_tractor_overview, get_tractor_engine_specs, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand slug from get_farm_tractor_brands or get_lawn_tractor_brands (e.g. 'johndeere', 'belarus', 'agco', 'kubota'). |
| `type` | string | No | Tractor type: 'farm' or 'lawn'. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-brand-models \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","type":"<string>"}'
```

### Get farm tractor brands

List all farm tractor brands/manufacturers available on TractorData.com. Returns brand name, slug, tractor count, year range, and horsepower range for each brand. No pagination; returns the complete list in one call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-farm-tractor-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get lawn tractor brands

List all lawn and garden tractor brands/manufacturers available on TractorData.com. Returns brand name, slug, tractor count, year range, and horsepower range for each brand. No pagination; returns the complete list in one call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-lawn-tractor-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get tractor attachments

Get attachment and loader information for a tractor model. Not all tractors have attachment data; returns an empty object when none is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-attachments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get tractor dimensions

Get physical dimensions, tire specifications, and weight data for a tractor model. Some tractors may have limited dimension data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-dimensions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get tractor engine specs

Get detailed engine specifications for a tractor model including displacement, bore/stroke, compression ratio, RPM, oil and coolant capacity. Returns data keyed by engine variant and specification category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-engine-specs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get tractor overview

Get overview specifications for a tractor model including production info, mechanical specs, capacity, hydraulics, hitch, PTO, dimensions, serial numbers, and electrical data. Returns a nested object keyed by specification category. Category keys vary by tractor model.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get tractor photos

Get photo gallery URLs for a tractor model. Returns URLs and alt text for available photos. Not all tractors have photos; returns an empty array when none is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-photos \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get tractor series

Get sibling models in the same series map for a tractor model. Returns related predecessor, successor, and peer models with their relative page paths. Not all tractors have series data; returns an empty array when none is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-series \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get tractor shows

List upcoming tractor shows and events with show name, date, and location (US state). No pagination; returns all upcoming shows.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-shows \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get tractor tests

Get official test data (e.g. Nebraska Tractor Tests) for a tractor model. Not all tractors have test data; returns an empty object when none is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-tests \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Get tractor transmission specs

Get transmission specifications for a tractor model including transmission type, gear count, oil capacity, and speed details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | Tractor page path from get_brand_models results (e.g. '/farm-tractors/000/0/6/64-john-deere-4020.html'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/get-tractor-transmission-specs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### Search tractors

Search for tractors by model name or number. Searches across all brands in the TractorData compare database. Returns up to 50 matching results. Searches model names only, not brand names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword matching tractor model name or number (e.g. '4020', 'L3400', 'DT160'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/tractordata/search-tractors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.