The Daily Beast API endpoint
Returns the current headlines of one The Daily Beast section. `section` is required and takes a slug such as `politics`, `politics/opinion`, `obsessed/reviews`, `scouted/home` or `world/china`. Each item can carry its title, URL, summary, author, publication time, lead image and `type`, and the response echoes the `section`.
/thedailybeast/headlinesQuery parameter: section is required and must be one of lifestyle, lifestyle/body, lifestyle/face, lifestyle/wellness, lifestyle/hair, lifestyle/style, travel, entertainment, entertainment/music, entertainment/tv, entertainment/movies, entertainment/comedy, entertainment/awards-shows, archive, media, tech, arts-and-culture, arts-and-culture/theater, arts-and-culture/royalist, arts-and-culture/fashion, arts-and-culture/books, innovation, innovation/science, obsessed, obsessed/shop, obsessed/hot-takes, obsessed/reviews, obsessed/recaps, obsessed/what-to-watch, obsessed/trailers, obsessed/interviews, obsessed/industry, obsessed/celebrity, obsessed/media, obsessed/media/shows, obsessed/media/movies, obsessed/media/music, obsessed/media/books, obsessed/rating, obsessed/rating/see, obsessed/rating/skip, obsessed/the-last-laugh, obsessed/obsessed-podcast, obsessed/obsessed-newsletter, politics, politics/biden-world, politics/congress, politics/elections, politics/national-security, politics/opinion, politics/trumpland, politics/pay-dirt, politics/trail-mix, politics/the-new-abnormal, scouted, scouted/fitness, scouted/wellness, scouted/beauty, scouted/bedroom, scouted/clothing, scouted/face-masks, scouted/home, scouted/kitchen, scouted/outdoors, scouted/technology, scouted/new-kids-on-the-block, scouted/the-case-for, scouted/thisthat, us-news, us-news/crime-and-justice, us-news/identities, us-news/sports, world, world/china, world/middle-east, world/europe, world/russia.
Use /api/v1/thedailybeast/sections to fetch this same list along with each section's display name and upstream URL.
| Field | Filled in, of 14 checked | Values in the sample |
|---|---|---|
| title | 14 | median 57 characters |
| url | 14 | thedailybeast.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | The Daily Beast section slug Allowed values: lifestyle, lifestyle/body, lifestyle/face, lifestyle/wellness, lifestyle/hair, lifestyle/style, travel, entertainment, entertainment/music, entertainment/tv, entertainment/movies, entertainment/comedy, entertainment/awards-shows, archive, media, tech, arts-and-culture, arts-and-culture/theater, arts-and-culture/royalist, arts-and-culture/fashion, arts-and-culture/books, innovation, innovation/science, obsessed, obsessed/shop, obsessed/hot-takes, obsessed/reviews, obsessed/recaps, obsessed/what-to-watch, obsessed/trailers, obsessed/interviews, obsessed/industry, obsessed/celebrity, obsessed/media, obsessed/media/shows, obsessed/media/movies, obsessed/media/music, obsessed/media/books, obsessed/rating, obsessed/rating/see, obsessed/rating/skip, obsessed/the-last-laugh, obsessed/obsessed-podcast, obsessed/obsessed-newsletter, politics, politics/biden-world, politics/congress, politics/elections, politics/national-security, politics/opinion, politics/trumpland, politics/pay-dirt, politics/trail-mix, politics/the-new-abnormal, scouted, scouted/fitness, scouted/wellness, scouted/beauty, scouted/bedroom, scouted/clothing, scouted/face-masks, scouted/home, scouted/kitchen, scouted/outdoors, scouted/technology, scouted/new-kids-on-the-block, scouted/the-case-for, scouted/thisthat, us-news, us-news/crime-and-justice, us-news/identities, us-news/sports, world, world/china, world/middle-east, world/europe, world/russia. | lifestyle | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/thedailybeast/headlines?section=lifestyle" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"section": "politics",
"items": [
{
"title": "Example headline",
"url": "https://www.thedailybeast.com/example-headline-with-several-words/"
}
]
}
}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 The Daily Beast top stories API. | |||
| data.section | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/thedailybeast/headlines?section=lifestyle" \
-H "x-api-key: $CRAWLORA_API_KEY"