Docs menu
NZ Herald API endpoint
NZ Herald author profile API
Returns an NZ Herald author profile from a required `url` in the form `https://www.nzherald.co.nz/author/<slug>/`. The response has `name`, `job_title`, `location`, `email`, `biography`, `image_url` and recent articles. Each field reflects what the author's page shows, and article `published_at` is RFC3339 where the page gives a machine-readable timestamp.
GETapiKey2 credits/requestNZ Heraldpublicnews.nzheraldAuthorResponseDoc
NZ Herald/nzherald/authorEndpoint facts
- Method
- GET
- API path
- /nzherald/author
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- NZ Herald
- Response schema
- #/definitions/publicnews.nzheraldAuthorResponseDoc
How this endpoint behaves
Returns an NZ Herald author's byline metadata, biography, headshot, contact details, and recent articles from a canonical author URL.
Query parameters:
url(required): a canonicalhttps://www.nzherald.co.nz/author/<slug>/URL.
job_title, location, email, and biography reflect whatever the
author's own page shows -- not every author has every field populated.
Each article's published_at is normalized to RFC3339 where the source page
provides a machine-readable timestamp.
Example response (truncated):
{"code":200,"data":{"url":"https://www.nzherald.co.nz/author/jane-doe/","name":"Jane Doe","job_title":"Senior Reporter","location":"Auckland","biography":["Jane Doe is a senior reporter for the New Zealand Herald."],"articles":[{"title":"Example headline","url":"https://www.nzherald.co.nz/nz/example-article-slug/ABCDEFGHIJKLMNOPQRST1234","published_at":"2026-09-24T07:00:00Z"}]}}
Sampled response
- Request, 14 Oct 2026
- GET /nzherald/author?url=https%3A%2F%2Fwww.nzherald.co.nz%2Fauthor%2Fal-williams%2F
- Items in articles
- 81
- Fields filled in every checked item
- 5
| Field | Filled in, of 81 checked | Values in the sample |
|---|---|---|
| title | 81 | median 80 characters |
| url | 81 | nzherald.co.nz |
| summary | 81 | median 83 characters |
| published_at | 81 | 2026-02-22 to 2026-10-12 |
| image_url | 81 | cloudfront-ap-southeast-2.images.arcpublishing.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical NZ Herald author URL | https://www.nzherald.co.nz/author/jane-doe/ | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/nzherald/author?url=https%3A%2F%2Fwww.nzherald.co.nz%2Fauthor%2Fjane-doe%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"url": "https://www.nzherald.co.nz/author/jane-doe/",
"name": "Jane Doe",
"job_title": "Senior Reporter",
"location": "Auckland",
"biography": [
"Jane Doe is a senior reporter for the New Zealand Herald."
],
"articles": [
{
"title": "Example headline",
"url": "https://www.nzherald.co.nz/nz/example-article-slug/ABCDEFGHIJKLMNOPQRST1234",
"published_at": "2026-09-24T07:00:00Z"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.nzheraldAuthorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | nzherald.AuthorResponse | No | ||||
| data.articles | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under NZ Herald top stories API. | |||
| data.biography | array | No | ||||
| data.email | string | No | ||||
| data.image_url | string | No | ||||
| data.job_title | string | No | ||||
| data.location | string | No | ||||
| data.name | 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/nzherald/author?url=https%3A%2F%2Fwww.nzherald.co.nz%2Fauthor%2Fjane-doe%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"