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

> Access car listings, automotive news, and location data from Webmotors, Brazil's largest automotive marketplace. Filter vehicles by make, model, year, price, mileage, and location to find detailed listing information programmatically.

**Category:** Automotive | **Website:** [webmotors.com.br/](https://webmotors.com.br/) | **Docs:** [parse.bot/marketplace/47e51db4-e495-4b50-9a34-a242b8033795/webmotors-com-br-api](https://parse.bot/marketplace/47e51db4-e495-4b50-9a34-a242b8033795/webmotors-com-br-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-webmotors-com-br-api-47e51db4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_locations

Get all available locations (cities) in Brazil with their coordinates and car listing counts. Returns a flat array of location objects. Useful for finding lat/lng values for location-based search_cars queries.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webmotors-com-br-api-47e51db4/get_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news

Extract news articles from the Webmotors news section. Returns a paginated list of articles with titles, full HTML text content, author name, publication date, and canonical URL. Pagination uses offset/limit; total_pages in the response indicates available depth.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of articles to return per page. |
| `offset` | integer | No | Offset for pagination (number of articles to skip). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webmotors-com-br-api-47e51db4/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### search_cars

Search for car listings with various filters. Make and model are used as URL path filters, while year, price, and km ranges are applied as query filters. Results include both promoted/sponsored listings (zero-km, limited metadata) and regular used car listings with full details including location and seller info. Returns paginated results with total count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `distance` | integer | No | Distance radius in km for location search. |
| `km_max` | integer | No | Maximum mileage in km. |
| `km_min` | integer | No | Minimum mileage in km. |
| `lat` | number | No | Latitude for location-based search. |
| `lng` | number | No | Longitude for location-based search. |
| `make` | string | No | Car make/brand (e.g. VOLKSWAGEN, TOYOTA, BMW, HONDA). Case insensitive. |
| `model` | string | No | Car model (e.g. GOL, COROLLA, CIVIC). Requires make to be set. Case insensitive. |
| `page` | integer | No | Page number for pagination. |
| `price_max` | integer | No | Maximum price in BRL. |
| `price_min` | integer | No | Minimum price in BRL. |
| `vehicle_type` | string | No | Vehicle type filter. Accepted values: 'carros' (all), 'carros-usados' (used only), 'carros-novos' (new only). |
| `year_from` | integer | No | Minimum year filter. |
| `year_to` | integer | No | Maximum year filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webmotors-com-br-api-47e51db4/search_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"distance":"<integer>","km_max":"<integer>","km_min":"<integer>","lat":"<number>","lng":"<number>","make":"<string>","model":"<string>","page":"<integer>","price_max":"<integer>","price_min":"<integer>","vehicle_type":"<string>","year_from":"<integer>","year_to":"<integer>"}'
```