# Tractordata — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_articles_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_brand_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_farm_tractor_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_lawn_tractor_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_attachments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_dimensions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_engine_specs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_photos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_shows \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_tests \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/get_tractor_transmission_specs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-tractordata-com-api-7a7067e9/search_tractors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```