Docs menu

GQ API endpoint

GQ article content API

Returns public GQ article metadata and body paragraphs from a canonical story URL. A story GQ marks as subscriber-only returns a 403 permission error instead of partial text.

GETapiKey2 credits/requestGQpublicnews.articleResponseDoc/gq/article

Endpoint facts

Method: GET
API path: /gq/article
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: GQ
Response schema: #/definitions/publicnews.articleResponseDoc

GQ scraping API Try GQ article content API in Playground GQ API documentation

How this endpoint behaves

Query parameter: required url, a canonical GQ story URL (https://www.gq.com/story/<slug>). Query strings and fragments are stripped and the URL is canonicalized to https://www.gq.com.

Returns one public GQ article's metadata (title, description, published_at, updated_at, section, authors, image_url) plus its body paragraphs in order.

Behavior:

Paywall-honest: a story that GQ's own page metadata marks as not free returns 403 instead of a body. No truncated or fabricated text is ever returned. Every story sampled while building this endpoint was free.
An article that yields metadata but no body paragraphs is treated as parser drift and returns 503.
Only /story/ URLs on gq.com are accepted. Galleries (/gallery/), videos, section pages, and other hosts return 400 before any upstream request.
An unknown story returns 404.

Sampled response

Request, 14 Oct 2026: GET /gq/article?url=https%3A%2F%2Fwww.gq.com%2Fstory%2Fhow-to-unclog-your-ear
Fields returned with a value: 9

Field	In the sample	Value in the sample
url	Has a value	gq.com
title	Has a value	22 characters
description	Has a value	130 characters
published_at	Has a value	2026-09-23
updated_at	Has a value	2026-09-23
section	Has a value	“grooming”
authors	Has a value	1 entry
image_url	Has a value	media.gq.com
paragraphs	Has a value	13 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical GQ story URL	https://www.gq.com/story/how-to-unclog-your-ear
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gq/article?url=https%3A%2F%2Fwww.gq.com%2Fstory%2Fhow-to-unclog-your-ear" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.gq.com/story/how-to-unclog-your-ear",
    "title": "How to Unclog Your Ear",
    "description": "Everything you need to know.",
    "published_at": "2026-09-22T13:00:00Z",
    "updated_at": "2026-09-23T19:36:22Z",
    "section": "grooming",
    "authors": [
      "Example Author"
    ],
    "image_url": "https://media.gq.com/photos/example/16:9/w_1920,h_1080,c_limit/ear.jpg",
    "paragraphs": [
      "First paragraph of the article.",
      "Second paragraph of the article."
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.articleResponseDoc

Field	Type	Required	Description
data	newsplatform.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.paragraphs	array	No
data.paywalled	boolean	No	Paywalled is true when the publisher serves only a teaser of this article to anonymous readers, so Paragraphs is a partial body rather than the full text. It is omitted when the full public body was returned.
data.published_at	string	No
data.section	string	No
data.title	string	No
data.updated_at	string	No
data.url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
403	Forbidden	#/definitions/app.Response
404	Not Found	#/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/article?url=https%3A%2F%2Fwww.gq.com%2Fstory%2Fhow-to-unclog-your-ear" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More GQ endpoint docs GQ scraping API GQ contributor profile API documentation GQ section headlines API documentation GQ top stories API documentation GQ sections API documentation

Open in Playground Back to group

Docs menu

GQ API endpoint

GQ article content API

Returns public GQ article metadata and body paragraphs from a canonical story URL. A story GQ marks as subscriber-only returns a 403 permission error instead of partial text.

GETapiKey2 credits/requestGQpublicnews.articleResponseDoc/gq/article

Endpoint facts

Method: GET
API path: /gq/article
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: GQ
Response schema: #/definitions/publicnews.articleResponseDoc

GQ scraping API Try GQ article content API in Playground GQ API documentation

How this endpoint behaves

Query parameter: required url, a canonical GQ story URL (https://www.gq.com/story/<slug>). Query strings and fragments are stripped and the URL is canonicalized to https://www.gq.com.

Returns one public GQ article's metadata (title, description, published_at, updated_at, section, authors, image_url) plus its body paragraphs in order.

Behavior:

Paywall-honest: a story that GQ's own page metadata marks as not free returns 403 instead of a body. No truncated or fabricated text is ever returned. Every story sampled while building this endpoint was free.
An article that yields metadata but no body paragraphs is treated as parser drift and returns 503.
Only /story/ URLs on gq.com are accepted. Galleries (/gallery/), videos, section pages, and other hosts return 400 before any upstream request.
An unknown story returns 404.

Sampled response

Request, 14 Oct 2026: GET /gq/article?url=https%3A%2F%2Fwww.gq.com%2Fstory%2Fhow-to-unclog-your-ear
Fields returned with a value: 9

Field	In the sample	Value in the sample
url	Has a value	gq.com
title	Has a value	22 characters
description	Has a value	130 characters
published_at	Has a value	2026-09-23
updated_at	Has a value	2026-09-23
section	Has a value	“grooming”
authors	Has a value	1 entry
image_url	Has a value	media.gq.com
paragraphs	Has a value	13 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical GQ story URL	https://www.gq.com/story/how-to-unclog-your-ear
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gq/article?url=https%3A%2F%2Fwww.gq.com%2Fstory%2Fhow-to-unclog-your-ear" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.gq.com/story/how-to-unclog-your-ear",
    "title": "How to Unclog Your Ear",
    "description": "Everything you need to know.",
    "published_at": "2026-09-22T13:00:00Z",
    "updated_at": "2026-09-23T19:36:22Z",
    "section": "grooming",
    "authors": [
      "Example Author"
    ],
    "image_url": "https://media.gq.com/photos/example/16:9/w_1920,h_1080,c_limit/ear.jpg",
    "paragraphs": [
      "First paragraph of the article.",
      "Second paragraph of the article."
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.articleResponseDoc

Field	Type	Required	Description
data	newsplatform.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.paragraphs	array	No
data.paywalled	boolean	No	Paywalled is true when the publisher serves only a teaser of this article to anonymous readers, so Paragraphs is a partial body rather than the full text. It is omitted when the full public body was returned.
data.published_at	string	No
data.section	string	No
data.title	string	No
data.updated_at	string	No
data.url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
403	Forbidden	#/definitions/app.Response
404	Not Found	#/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/article?url=https%3A%2F%2Fwww.gq.com%2Fstory%2Fhow-to-unclog-your-ear" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More GQ endpoint docs GQ scraping API GQ contributor profile API documentation GQ section headlines API documentation GQ top stories API documentation GQ sections API documentation

Open in Playground Back to group

GQ article content API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

GQ article content API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related