# Autonews — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/autonews/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-article-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-asia-headlines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-canada-headlines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-category-headlines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-europe-headlines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-homepage-headlines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-latest-headlines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/get-news-by-brand \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/autonews/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.