TheJournal.ie API endpoint
Returns one TheJournal.ie author's public archive page: name, numeric author id, and the most recent articles the first page lists.
/thejournal/authorQuery parameters:
slug (optional): an author slug, e.g. ottoline-spearman, the second-to-last segment of the author link in a story's byline.url (optional): a canonical https://www.thejournal.ie/author/<slug>/ URL, optionally with the numeric id (/author/<slug>/<id>/), as an alternative to slug.Exactly one of slug/url is required. The response covers the first page of the author's archive (about 40 articles, no further pagination; has_more is true when older articles exist); each article has title, url, section (the card label), summary and image_url when shown. The author page has no biography or social links, and its cards show only relative times, so neither is returned. An unknown author returns HTTP 404.
Example response (truncated):
{"code":200,"data":{"name":"Ottoline Spearman","slug":"ottoline-spearman","id":"9329","url":"https://www.thejournal.ie/author/ottoline-spearman/9329/","has_more":true,"articles":[{"title":"Some Amazon customers will receive cheques for up to $200 following settlement with US regulators","url":"https://www.thejournal.ie/amazon-refunds-200-cheques-7170610-Sep2026","section":"Great News","image_url":"https://img2.thejournal.ie/article/7170610/river?version=7171290&width=230"}]}}
| Field | Filled in, of 35 checked | Values in the sample |
|---|---|---|
| title | 35 | median 78 characters |
| url | 35 | thejournal.ie |
| image_url | 35 | img2.thejournal.ie and 1 other host |
| section | 32 | |
| summary | 1 | median 70 characters |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug | string | No | Author slug, e.g. ottoline-spearman | ottoline-spearman | |
| url | string | No | Canonical thejournal.ie/author/<slug>/ URL, optionally with the numeric author id; alternative to slug | https://www.thejournal.ie/author/ottoline-spearman/9329/ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/thejournal/author" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"name": "Ottoline Spearman",
"slug": "ottoline-spearman",
"id": "9329",
"url": "https://www.thejournal.ie/author/ottoline-spearman/9329/",
"has_more": true,
"articles": [
{
"title": "Some Amazon customers will receive cheques for up to $200 following settlement with US regulators",
"url": "https://www.thejournal.ie/amazon-refunds-200-cheques-7170610-Sep2026",
"section": "Great News",
"image_url": "https://img2.thejournal.ie/article/7170610/river?version=7171290&width=230"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.theJournalAuthorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | thejournal.AuthorResponse | No | ||||
| data.articles | array | No | ||||
| data.articles[].image_url | string | No | ||||
| data.articles[].section | string | No | ||||
| data.articles[].summary | string | No | ||||
| data.articles[].title | string | No | ||||
| data.articles[].url | string | No | ||||
| data.has_more | boolean | No | ||||
| data.id | string | No | ||||
| data.name | string | No | ||||
| data.slug | string | No | ||||
| data.url | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/thejournal/author" \
-H "x-api-key: $CRAWLORA_API_KEY"