# List — 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 browse vehicles, parts, and accessories listings on the Armenian List.am marketplace, filter by category, view detailed listing information, and retrieve seller contact numbers. Access comprehensive vehicle catalogs with category filtering to find exactly what you're looking for.

**Category:** Automotive | **Website:** [list.am/](https://list.am/) | **Docs:** [parse.bot/marketplace/71081b21-3c4d-459d-b602-358d7c6ef2e9/list-am-api](https://parse.bot/marketplace/71081b21-3c4d-459d-b602-358d7c6ef2e9/list-am-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-list-am-api-71081b21/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_car_listings_filtered

Fetch filtered car listings from the Passenger Cars category (687). Supports filtering by brand, model, year range, price range, and currency. All filter parameters are optional; omitting all returns unfiltered results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_id` | string | No | Brand ID (e.g. 49 for Mercedes-Benz). |
| `currency` | string | No | Currency for price filter: 0 for AMD, 1 for USD. |
| `model_id` | string | No | Model ID within the selected brand. |
| `page` | integer | No | Page number for pagination. |
| `price_from` | string | No | Minimum price filter. |
| `price_to` | string | No | Maximum price filter. |
| `year_from` | string | No | Minimum year filter. |
| `year_to` | string | No | Maximum year filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-list-am-api-71081b21/get_car_listings_filtered \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"<string>","currency":"<string>","model_id":"<string>","page":"<integer>","price_from":"<string>","price_to":"<string>","year_from":"<string>","year_to":"<string>"}'
```

### get_category_listings

Fetch paginated listings from a specific category. Returns listing summaries including title, price, location, and thumbnail image URL. Supports optional search within the category via query parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID (e.g. 687 for Passenger Cars, 530 for Car Parts, 238 for Wheels and Tires). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Optional search query to filter results within the category. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-list-am-api-71081b21/get_category_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>","query":"<string>"}'
```

### get_listing_detail

Fetch full details of a single listing including attributes, images, description, seller information, and dates. At least one of item_id or url must be provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | No | Listing item ID. Either item_id or url must be provided. |
| `url` | string | No | Full listing URL as a fallback if item_id is not provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-list-am-api-71081b21/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","url":"<string>"}'
```

### get_phone_number

Fetch the phone number for a specific listing (requires Cloudflare clearance).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Item ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-list-am-api-71081b21/get_phone_number \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_vehicles_categories

Fetch the vehicle and parts category tree with IDs that can be used with get_category_listings and get_car_listings_filtered. Returns a static hierarchy of automotive categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-list-am-api-71081b21/get_vehicles_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_listings

Search for listings across all categories or within a specific category. Returns paginated listing summaries matching the search query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Optional category ID to scope the search to a specific category. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-list-am-api-71081b21/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>","query":"<string>"}'
```