Docs menu
HuffPost API endpoint
HuffPost top stories API
Returns HuffPost's current top stories from its homepage, with no parameters. Each item has its title, URL and image where available. Summary, author and publication time are not returned.
GETapiKey1 credit/requestHuffPostpublicnews.newsResponseDoc
HuffPost/huffpost/newsEndpoint facts
- Method
- GET
- API path
- /huffpost/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- HuffPost
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns fresh public HuffPost headline metadata from the site's public homepage.
Sampled response
- Request, 14 Oct 2026
- GET /huffpost/news
- Items in items
- 82
- Fields filled in every checked item
- 3
| Field | Filled in, of 82 checked | Values in the sample |
|---|---|---|
| title | 82 | median 77 characters |
| url | 82 | huffpost.com |
| image_url | 82 | img.huffingtonpost.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/huffpost/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"items": [
{
"title": "Example HuffPost headline",
"url": "https://www.huffpost.com/entry/example-story_n_1234567890abcdef12345678",
"image_url": "https://img.huffingtonpost.com/asset/example.jpeg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.NewsResponse | No | ||||
| data.items | array | No | ||||
| data.items[].author | string | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].summary | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].type | string | No | ||||
| data.items[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/huffpost/news" \
-H "x-api-key: $CRAWLORA_API_KEY"