Docs menu

Stuff API endpoint

Stuff article API

Returns public Stuff article metadata and body paragraphs from a canonical article URL. A story the publisher marks premium is reported as paywalled, or refused with a permission error when no free text is available.

GETapiKey2 credits/requestStuffpublicnews.articleResponseDoc/stuff/article

Endpoint facts

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

Stuff Scraper API Try Stuff article API in Playground Stuff API documentation

How this endpoint behaves

Query parameter: url is required: a canonical HTTPS www.stuff.co.nz story URL in the form /<section>/<id>/<slug> (the numeric id is what is looked up). Returns public metadata and the article body as paragraphs (paragraphs, subheadings and list items in reading order). The story's key-points summary box is left out because it repeats the body.

Stuff marks each story open or premium. If a story is premium, the response sets paywalled to true and paragraphs holds only whatever text the publisher serves without a subscription; if none is served the endpoint returns a permission error rather than an empty or fabricated body. Stories are open in every sample checked. Live blogs return the current text of the blog post.

Sampled response

Request, 14 Oct 2026: GET /stuff/article?url=https%3A%2F%2Fwww.stuff.co.nz%2Fsport%2F361037655%2Fnew-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby
Fields returned with a value: 9

Field	In the sample	Value in the sample
url	Has a value	stuff.co.nz
title	Has a value	77 characters
description	Has a value	127 characters
published_at	Has a value	2026-09-24
updated_at	Has a value	2026-09-24
section	Has a value	“Sport”
authors	Has a value	1 entry
image_url	Has a value	stuff.co.nz
paragraphs	Has a value	18 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical Stuff article URL	https://www.stuff.co.nz/sport/361037655/new-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/stuff/article?url=https%3A%2F%2Fwww.stuff.co.nz%2Fsport%2F361037655%2Fnew-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.stuff.co.nz/sport/361000001/example-story",
    "title": "Example article",
    "published_at": "2026-09-24T19:00:00Z",
    "section": "Sport",
    "authors": [
      "Example Reporter"
    ],
    "paragraphs": [
      "Example public paragraph."
    ]
  }
}

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/stuff/article?url=https%3A%2F%2Fwww.stuff.co.nz%2Fsport%2F361037655%2Fnew-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Stuff endpoint docs Stuff Scraper API Stuff author profile API documentation Stuff section headlines API documentation Stuff top stories API documentation Stuff sections API documentation

Open in Playground Back to group

Docs menu

Stuff API endpoint

Stuff article API

GETapiKey2 credits/requestStuffpublicnews.articleResponseDoc/stuff/article

Endpoint facts

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

Stuff Scraper API Try Stuff article API in Playground Stuff API documentation

How this endpoint behaves

Sampled response

Request, 14 Oct 2026: GET /stuff/article?url=https%3A%2F%2Fwww.stuff.co.nz%2Fsport%2F361037655%2Fnew-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby
Fields returned with a value: 9

Field	In the sample	Value in the sample
url	Has a value	stuff.co.nz
title	Has a value	77 characters
description	Has a value	127 characters
published_at	Has a value	2026-09-24
updated_at	Has a value	2026-09-24
section	Has a value	“Sport”
authors	Has a value	1 entry
image_url	Has a value	stuff.co.nz
paragraphs	Has a value	18 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical Stuff article URL	https://www.stuff.co.nz/sport/361037655/new-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/stuff/article?url=https%3A%2F%2Fwww.stuff.co.nz%2Fsport%2F361037655%2Fnew-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.stuff.co.nz/sport/361000001/example-story",
    "title": "Example article",
    "published_at": "2026-09-24T19:00:00Z",
    "section": "Sport",
    "authors": [
      "Example Reporter"
    ],
    "paragraphs": [
      "Example public paragraph."
    ]
  }
}

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/stuff/article?url=https%3A%2F%2Fwww.stuff.co.nz%2Fsport%2F361037655%2Fnew-mum-sarah-hirini-eyes-third-olympic-gold-after-confirming-return-rugby" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Stuff endpoint docs Stuff Scraper API Stuff author profile API documentation Stuff section headlines API documentation Stuff top stories API documentation Stuff sections API documentation

Open in Playground Back to group

Stuff article API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Stuff article API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related