Liverpool Echo API endpoint
Returns one Liverpool Echo author's public profile: name, job title, bio, email, X/Twitter handle, and one page of their recent articles.
/liverpoolecho/authorQuery parameters:
slug (optional): an author slug, e.g. wesley-holmes.url (optional): a canonical https://www.liverpoolecho.co.uk/authors/<slug>/ URL, optionally with the site's own ?pageNumber=<n> query, as an alternative to slug.page (optional): 1-based page number of the author's article list, from 1 to 100; overrides any pageNumber in url. Defaults to 1.Exactly one of slug/url is required. Each page lists about 24 articles and has_next_page reports whether the site's own pagination shows a further page. email and twitter are the author's own contact links; unlisted contact details are simply absent, not an error. An unknown slug returns a 404 error.
Example response (truncated):
{"code":200,"data":{"name":"Wesley Holmes","slug":"wesley-holmes","url":"https://www.liverpoolecho.co.uk/authors/wesley-holmes/","job_title":"Liverpool Echo reporter","bio":"Example biography.","email":"[email protected]","twitter":"https://twitter.com/wesjourno","page":1,"has_next_page":true,"articles":[{"title":"Example headline","url":"https://www.liverpoolecho.co.uk/news/liverpool-news/example-headline-34665907","label":"Whiston","label_url":"https://www.liverpoolecho.co.uk/all-about/whiston"}]}}
| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| title | 24 | median 68 characters |
| url | 24 | liverpoolecho.co.uk |
| label | 24 | |
| label_url | 24 | liverpoolecho.co.uk |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug | string | No | Author slug, e.g. wesley-holmes | wesley-holmes | |
| url | string | No | Canonical liverpoolecho.co.uk/authors/<slug>/ URL; alternative to slug | https://www.liverpoolecho.co.uk/authors/wesley-holmes/ | |
| page | integer | No | 1-based page number of the author's article list (1 to 100); overrides any pageNumber in url | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/liverpoolecho/author?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"name": "Wesley Holmes",
"slug": "wesley-holmes",
"url": "https://www.liverpoolecho.co.uk/authors/wesley-holmes/",
"job_title": "Liverpool Echo reporter",
"bio": "Example biography.",
"email": "[email protected]",
"twitter": "https://twitter.com/wesjourno",
"page": 1,
"has_next_page": true,
"articles": [
{
"title": "Example headline",
"url": "https://www.liverpoolecho.co.uk/news/liverpool-news/example-headline-34665907",
"label": "Whiston",
"label_url": "https://www.liverpoolecho.co.uk/all-about/whiston"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.reachAuthorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | reachplc.AuthorResponse | No | ||||
| data.articles | array | No | ||||
| data.articles[].label | string | No | ||||
| data.articles[].label_url | string | No | ||||
| data.articles[].title | string | No | ||||
| data.articles[].url | string | No | ||||
| data.bio | string | No | ||||
| data.email | string | No | ||||
| data.has_next_page | boolean | No | ||||
| data.job_title | string | No | ||||
| data.name | string | No | ||||
| data.page | integer | No | ||||
| data.slug | string | No | ||||
| data.twitter | string | No | ||||
| data.url | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/liverpoolecho/author?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"