Docs menu
VICE API endpoint
VICE section headlines API
Returns fresh headlines from one VICE section, either its public RSS feed (News, Life, Tech, Music) or its public listing page for the remaining sections.
GETapiKey1 credit/requestVICEpublicnews.headlinesResponseDoc
VICE/vice/headlinesEndpoint facts
- Method
- GET
- API path
- /vice/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- VICE
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of news, life,
tech, music, munchies, waypoint, rec-room, membership,
via-vice, spotlights, theunstoppables, or eu.
For news, munchies, waypoint, rec-room, membership, via-vice,
spotlights, theunstoppables, and eu, which have no working section RSS
feed, items are listed from the section's public listing page instead.
Sampled response
- Request, 14 Oct 2026
- GET /vice/headlines?section=tech
- Items in items
- 10
- Fields filled in every checked item
- 5
- Fields empty in some or all items
- 1
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| title | 10 | median 69 characters |
| url | 10 | vice.com |
| summary | 10 | median 436 characters |
| published_at | 10 | 2026-09-03 to 2026-10-09 |
| author | 10 | |
| image_url | 3 | youtube.com and 1 other host |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | VICE section slug Allowed values: news, life, tech, music, munchies, waypoint, rec-room, membership, via-vice, spotlights, theunstoppables, eu. | news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/vice/headlines?section=news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "tech",
"items": [
{
"title": "Example headline",
"url": "https://www.vice.com/en/article/example-article"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under VICE top stories API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 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/vice/headlines?section=news" \
-H "x-api-key: $CRAWLORA_API_KEY"