autonews APIautonews.com ↗
Access Automotive News headlines, article search, brand-specific news, and regional coverage for Europe, Canada, and Asia via a structured REST API.
What is the autonews API?
The Automotive News API exposes 9 endpoints covering the full editorial output of autonews.com, including get_latest_headlines for paginated feed access, category and region-specific endpoints, brand-level news lookup, and keyword search. Each article object returns up to nine structured fields: headline, description, url, image_url, category, published_at, authors, tags, and a unique id. The API is suited for monitoring industry news across retail, manufacturing, EV, and technology verticals as well as geographic markets.
curl -X GET 'https://api.parse.bot/scraper/498c48f7-52dd-4787-af1f-3ac8d6be98f8/get_latest_headlines?limit=5&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace autonews-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Automotive News SDK — bounded, re-runnable; every call capped."""
from parse_apis.automotive_news_api import AutomotiveNews, Category, ArticleNotFound
client = AutomotiveNews()
# Browse the latest headlines — limit caps total items fetched.
for article in client.articles.latest(limit=3):
print(article.headline, article.published_at)
# Search by keyword and drill into the first result.
result = client.articles.search(query="electric vehicles", limit=1).first()
if result:
detail = client.articles.get(url=result.url)
print(detail.headline, detail.category, detail.authors)
# Filter by category using the Category enum.
for article in client.articles.by_category(category=Category.EV, limit=3):
print(article.headline, article.authors)
# Check brand-specific coverage.
for article in client.articles.by_brand(brand="Toyota", limit=3):
print(article.headline, article.published_at)
# Typed error handling for a missing article.
try:
client.articles.get(url="https://www.autonews.com/nonexistent-article-path/")
except ArticleNotFound as exc:
print(f"Article not found: {exc.url}")
print("exercised: articles.latest / articles.search / articles.get / articles.by_category / articles.by_brand")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.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of articles to return. |
| offset | integer | Offset for pagination. |
{
"type": "object",
"fields": {
"articles": "array of article objects with id, headline, url, description, image_url, category, published_at, authors, and tags"
},
"sample": {
"data": {
"articles": [
{
"id": "E7NO7IMYTBBTNBYXOOLNVPAU7I",
"url": "https://www.autonews.com/stellantis/dodge/an-dodge-fathers-day-fragrance-0611/",
"tags": [],
"authors": [
"Ad Age Staff"
],
"category": "",
"headline": "This Father’s Day, Dodge says Dad needs the scent of a Hemi",
"image_url": "https://cloudfront-us-east-1.images.arcpublishing.com/crain/VTCCUTPXWRHS3MSJQ3HKGQCCOE.jpg",
"description": "A social-media campaign spoofs classic fragrance advertising.",
"published_at": "2026-06-11T10:00:01Z"
}
]
},
"status": "success"
}
}About the autonews API
What the API Returns
Every article-bearing endpoint returns a consistent object shape with id, headline, url, description, image_url, category, published_at, authors, and tags. The published_at field is an ISO 8601 timestamp, making it straightforward to sort or filter results by recency in your application. The authors field is an array of name strings, and tags is a flat array of topic strings attached to the article by Automotive News editors.
Navigating Categories and Regions
get_category_headlines accepts a required category parameter with verified values including retail, manufacturing, ev, technology, europe, canada, and asia. For convenience, dedicated endpoints — get_europe_headlines, get_canada_headlines, and get_asia_headlines — return regional articles directly without requiring a parameter. Both approaches return the same article object shape along with a category confirmation field.
Search and Brand Lookup
search_articles accepts a query string plus optional limit and offset for pagination, and uniquely returns a total integer alongside the results array — useful for building paginated UIs or estimating corpus size for a given topic. get_news_by_brand accepts a brand string (e.g., Tesla, Ford, Toyota) and attempts to locate articles from a brand-dedicated section before falling back to search, making it the most targeted way to track automaker-specific coverage.
Article Detail Lookup
get_article_details accepts a full url from autonews.com and returns the complete metadata object for that article. This is useful when you have a URL from an external reference and need to resolve structured metadata — category, tags, authors, image, and description — without re-running a search query.
The autonews API is a managed, monitored endpoint for autonews.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when autonews.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official autonews.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track EV industry coverage by polling
get_category_headlineswith categoryevand monitoring newpublished_attimestamps. - Build a competitive intelligence feed by querying
get_news_by_brandfor multiple automakers and aggregating results by brand. - Populate a news widget with homepage-curated articles using
get_homepage_headlines, which returns up to 10 editorially selected pieces. - Search earnings-adjacent coverage by passing financial terms to
search_articlesand using thetotalfield to gauge story volume. - Monitor Canadian and European market news separately using
get_canada_headlinesandget_europe_headlineswithout parameter configuration. - Resolve article metadata from an externally sourced URL by passing it to
get_article_detailsto retrieve tags, authors, and category. - Archive automotive retail news by paginating
get_category_headlineswith theretailcategory usinglimitandoffsetparameters.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Automotive News offer an official developer API?+
What does `get_article_details` return that feed endpoints do not?+
get_article_details is functionally identical in response shape but is the only endpoint that resolves a full autonews.com URL directly to metadata — useful when you already have a URL and want to avoid a separate search round-trip.Does `search_articles` support filtering by date range or category?+
search_articles accepts only a query string plus limit and offset. It does not support filtering by published_at date range or by category within the query parameters. Results include a total count and a category field per article, so post-response filtering is possible client-side. You can fork this API on Parse and revise it to add a date-range or category filter parameter to the search endpoint.Does the API return full article body text?+
How fresh are the headlines returned by `get_latest_headlines`?+
published_at. Automotive News publishes throughout the business day, so freshness depends on publication cadence rather than a fixed polling interval. For near-real-time monitoring, polling get_latest_headlines at regular intervals and comparing id or published_at values is the standard approach.