Docs menu
GQ API endpoint
GQ section headlines API
Returns the story cards currently on one GQ section page. `section` is required and takes one of 11 slugs such as `style`, `grooming`, `watches` or `gqsports`. Each item has its `title`, `url`, `summary`, `author`, `image_url` and a `published_at` date (`YYYY-MM-DD`). Only `/story/` articles are listed, and fields GQ does not show are omitted.
GETapiKey1 credit/requestGQpublicnews.headlinesResponseDoc
GQ/gq/headlinesEndpoint facts
- Method
- GET
- API path
- /gq/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- GQ
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of culture, entertainment, fitness, gq-hype, gq-recommends, gqsports, grooming, politics, style, watches, or wellness (see gq-sections). Any other value returns 400 before an upstream request is made.
Returns the story cards currently shown on that section's page: title, url, summary (the standfirst), author, published_at, and image_url. Only /story/ articles are returned; galleries and videos are skipped. Section pages show a calendar date only, so published_at is YYYY-MM-DD here (the gq-news feed returns full timestamps). Fields GQ does not show on a card are omitted rather than guessed. A page that yields no story cards is reported as an upstream error (503) rather than an empty success.
Sampled response
- Request, 14 Oct 2026
- GET /gq/headlines?section=style
- Items in items
- 47
- Fields filled in every checked item
- 4
- Fields empty in some or all items
- 2
| Field | Filled in, of 47 checked | Values in the sample |
|---|---|---|
| title | 47 | median 55 characters |
| url | 47 | gq.com |
| summary | 47 | median 120 characters |
| published_at | 33 | 2026-09-22 to 2026-10-13 |
| author | 36 | |
| image_url | 47 | media.gq.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | GQ section slug Allowed values: culture, entertainment, fitness, gq-hype, gq-recommends, gqsports, grooming, politics, style, watches, wellness. | culture | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/gq/headlines?section=culture" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "style",
"items": [
{
"title": "Inside the Closets of 13 Influential Men",
"url": "https://www.gq.com/story/closet-tours-with-13-influential-men",
"summary": "We ventured into closets the world over.",
"author": "The Editors of GQ",
"published_at": "2026-09-21",
"image_url": "https://media.gq.com/photos/6aa30603a93731c06cca7be2/4:3/w_1024%2Cc_limit/Closets-GIF.gif"
}
]
}
}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 GQ 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/gq/headlines?section=culture" \
-H "x-api-key: $CRAWLORA_API_KEY"