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

> Stay updated on the automotive industry with instant access to headlines, articles, and news across global regions (Europe, Canada, Asia), specific brands, and industry categories. Search for relevant automotive news, read detailed articles, and browse the latest stories from Automotive News all in one place.

**Category:** News & Media | **Website:** [autonews.com/](https://autonews.com/) | **Docs:** [parse.bot/marketplace/2756fafb-4cbc-41e8-bdc6-05c136c5e35c/autonews-com-api](https://parse.bot/marketplace/2756fafb-4cbc-41e8-bdc6-05c136c5e35c/autonews-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-autonews-com-api-2756fafb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article_details

Get detailed metadata for a specific article by its URL. Returns article information including tags, authors, category, and publication timestamp. The URL must be a full autonews.com article URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the article on autonews.com. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_article_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_asia_headlines

Fetch the latest headlines from the Asia section. Returns articles tagged or filed under Asian automotive news. Convenience endpoint equivalent to get_category_headlines with category 'asia'.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_asia_headlines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_canada_headlines

Fetch the latest headlines from the Canada section. Returns articles tagged or filed under Canadian automotive news. Convenience endpoint equivalent to get_category_headlines with category 'canada'.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_canada_headlines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_category_headlines

Fetch headlines for a specific category section. Returns paginated articles filed under the given category. The response includes the queried category name alongside the article list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category section path. |
| `limit` | integer | No | Maximum number of articles to return. |
| `offset` | integer | No | Offset for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_category_headlines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","offset":"<integer>"}'
```

### get_europe_headlines

Fetch the latest headlines from the Europe section. Returns articles tagged or filed under European automotive news. Convenience endpoint equivalent to get_category_headlines with category 'europe'.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_europe_headlines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_homepage_headlines

Fetch featured headlines from the homepage curated collections. Returns up to 10 featured articles selected by editorial staff.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_homepage_headlines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_headlines

Fetch a feed of the latest headlines from Automotive News. Returns articles ordered by publish date. Supports offset-based pagination via limit and offset parameters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return. |
| `offset` | integer | No | Offset for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_latest_headlines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### get_news_by_brand

Fetch news for an automaker brand. Tries the brand's dedicated section first, then falls back to keyword search. Returns articles relevant to the specified brand.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Automaker brand name (e.g., Tesla, Toyota, Ford, BMW, Volvo). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/get_news_by_brand \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>"}'
```

### search_articles

Search for articles by keyword or phrase. Returns paginated results with the total count of matching articles. Results are ordered by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Offset for pagination. |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autonews-com-api-2756fafb/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```