Docs menu

Stuff API endpoint

Stuff author profile API

Returns a Stuff (New Zealand) author's profile, looked up by `slug` (for example `damien-venuto`) or canonical `url`; exactly one is required. The response has the name, `job_title`, `location`, biography, headshot, `email` and recent stories. Fields show only what the profile has; shared team bylines usually carry just a job title. An unknown author returns not found.

GETapiKey2 credits/requestStuffpublicnews.stuffAuthorResponseDoc/stuff/author

Endpoint facts

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

Stuff Scraper API Try Stuff author profile API in Playground Stuff API documentation

How this endpoint behaves

Query parameters:

slug (optional): an author slug, e.g. damien-venuto.
url (optional): a canonical https://www.stuff.co.nz/authors/<slug> URL, as an alternative to slug.

Exactly one of slug/url is required. job_title, location, email, biography and image_url reflect what the author's profile shows; shared team bylines such as stuff-sports-reporters usually have only a job title. An unknown author returns not found.

Example response (truncated):

{"code":200,"data":{"name":"Example Author","slug":"example-author","url":"https://www.stuff.co.nz/authors/example-author","job_title":"Money Editor","location":"Auckland","email":"[email protected]","biography":"Example biography.","articles":[{"title":"Example headline","url":"https://www.stuff.co.nz/money/361000001/example-story","published_at":"2026-09-24T19:00:00Z","author":"Example Author"}]}}

Sampled response

Request, 14 Oct 2026: GET /stuff/author?slug=damien-venuto
Items in articles: 20
Fields filled in every checked item: 6

Field	Filled in, of 20 checked	Values in the sample
title	20	median 80 characters
url	20	stuff.co.nz
summary	20	median 78 characters
published_at	20	2026-09-03 to 2026-10-13
author	20
image_url	20	stuff.co.nz

Request parameters

Parameter	Type	Required	Description	Example
slug	string	No	Author slug, e.g. damien-venuto	damien-venuto
url	string	No	Canonical stuff.co.nz/authors/<slug> URL; alternative to slug	https://www.stuff.co.nz/authors/damien-venuto
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/stuff/author" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "name": "Example Author",
    "slug": "example-author",
    "url": "https://www.stuff.co.nz/authors/example-author",
    "job_title": "Money Editor",
    "location": "Auckland",
    "email": "[email protected]",
    "biography": "Example biography.",
    "articles": [
      {
        "title": "Example headline",
        "url": "https://www.stuff.co.nz/money/361000001/example-story",
        "published_at": "2026-09-24T19:00:00Z",
        "author": "Example Author"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.stuffAuthorResponseDoc

Field	Type	Required
data	stuff.AuthorResponse	No
data.articles	array	No
data.articles[].author	string	No
data.articles[].image_url	string	No
data.articles[].published_at	string	No
data.articles[].summary	string	No
data.articles[].title	string	No
data.articles[].type	string	No
data.articles[].url	string	No
data.biography	string	No
data.email	string	No
data.image_url	string	No
data.job_title	string	No
data.location	string	No
data.name	string	No
data.slug	string	No
data.url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/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/author" \
  -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 article 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 author profile API

GETapiKey2 credits/requestStuffpublicnews.stuffAuthorResponseDoc/stuff/author

Endpoint facts

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

Stuff Scraper API Try Stuff author profile API in Playground Stuff API documentation

How this endpoint behaves

Query parameters:

slug (optional): an author slug, e.g. damien-venuto.
url (optional): a canonical https://www.stuff.co.nz/authors/<slug> URL, as an alternative to slug.

Example response (truncated):

{"code":200,"data":{"name":"Example Author","slug":"example-author","url":"https://www.stuff.co.nz/authors/example-author","job_title":"Money Editor","location":"Auckland","email":"[email protected]","biography":"Example biography.","articles":[{"title":"Example headline","url":"https://www.stuff.co.nz/money/361000001/example-story","published_at":"2026-09-24T19:00:00Z","author":"Example Author"}]}}

Sampled response

Request, 14 Oct 2026: GET /stuff/author?slug=damien-venuto
Items in articles: 20
Fields filled in every checked item: 6

Field	Filled in, of 20 checked	Values in the sample
title	20	median 80 characters
url	20	stuff.co.nz
summary	20	median 78 characters
published_at	20	2026-09-03 to 2026-10-13
author	20
image_url	20	stuff.co.nz

Request parameters

Parameter	Type	Required	Description	Example
slug	string	No	Author slug, e.g. damien-venuto	damien-venuto
url	string	No	Canonical stuff.co.nz/authors/<slug> URL; alternative to slug	https://www.stuff.co.nz/authors/damien-venuto
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/stuff/author" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "name": "Example Author",
    "slug": "example-author",
    "url": "https://www.stuff.co.nz/authors/example-author",
    "job_title": "Money Editor",
    "location": "Auckland",
    "email": "[email protected]",
    "biography": "Example biography.",
    "articles": [
      {
        "title": "Example headline",
        "url": "https://www.stuff.co.nz/money/361000001/example-story",
        "published_at": "2026-09-24T19:00:00Z",
        "author": "Example Author"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.stuffAuthorResponseDoc

Field	Type	Required
data	stuff.AuthorResponse	No
data.articles	array	No
data.articles[].author	string	No
data.articles[].image_url	string	No
data.articles[].published_at	string	No
data.articles[].summary	string	No
data.articles[].title	string	No
data.articles[].type	string	No
data.articles[].url	string	No
data.biography	string	No
data.email	string	No
data.image_url	string	No
data.job_title	string	No
data.location	string	No
data.name	string	No
data.slug	string	No
data.url	string	No

Failure responses

Status	Description	Schema
400	Bad Request	#/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/author" \
  -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 article API documentation Stuff section headlines API documentation Stuff top stories API documentation Stuff sections API documentation

Open in Playground Back to group

Stuff author profile API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Stuff author profile API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related