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

> Browse and search detailed information on over 14,000 automotive brands and 6,000 concept cars, organized by region, country, and model specifications. Discover vehicle data across the world's largest automotive encyclopedia with instant access to brand details, model information, and comprehensive search capabilities.

**Category:** Automotive | **Website:** [allcarindex.com/](https://allcarindex.com/) | **Docs:** [parse.bot/marketplace/2e26de9b-3d8a-4ad2-9e3a-38bd63f17d00/allcarindex-com-api](https://parse.bot/marketplace/2e26de9b-3d8a-4ad2-9e3a-38bd63f17d00/allcarindex-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-allcarindex-com-api-2e26de9b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_regions

Retrieve a list of all geographic regions available for browsing brands. Returns a static list of 6 regions with name and slug.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allcarindex-com-api-2e26de9b/get_all_regions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_brand_detail

Retrieve detailed information about a specific car brand including company history, production years, places, and company names across different eras. Requires a country slug and brand slug, both obtainable from get_brands_list results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_slug` | string | Yes | URL slug of the brand (e.g. bmw, aaa, peugeot). Obtained from get_brands_list results. |
| `country` | string | Yes | Country slug of the brand (e.g. france, germany, united-kingdom). Obtained from get_brands_list results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allcarindex-com-api-2e26de9b/get_brand_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_slug":"<string>","country":"<string>"}'
```

### get_brands_by_country

Retrieve the count of car brands and models from a specific country. Uses the search interface to find brand and model totals for the given country.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | Yes | Country name slug (e.g. france, germany, japan, united-kingdom). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allcarindex-com-api-2e26de9b/get_brands_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>"}'
```

### get_brands_list

Retrieve a paginated list of car brands filtered by geographic region and starting letter. Returns 12 brands per page. Each brand includes name, country, production years, image URL, and a slug usable for detail lookup. Pagination metadata includes current page, total pages, and whether more pages exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Starting letter of the brand name (a-z, 0-9). |
| `max_year` | integer | No | Maximum production year filter. |
| `min_year` | integer | No | Minimum production year filter. |
| `page` | integer | No | Page number for pagination. |
| `region` | string | No | Geographic region to browse. |
| `sort` | string | No | Sort order for results. Leave empty for default (alphabetical A-Z). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allcarindex-com-api-2e26de9b/get_brands_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>","max_year":"<integer>","min_year":"<integer>","page":"<integer>","region":"<string>","sort":"<string>"}'
```

### search

Search the AllCarIndex database by keyword. Returns the count of matching brands, models, and blog posts. Individual result items are not publicly accessible; only aggregate counts are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. BMW, Toyota, Peugeot). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allcarindex-com-api-2e26de9b/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```