Docs menu
TheJournal.ie API endpoint
TheJournal.ie article API
Returns public TheJournal.ie article metadata and body paragraphs from a canonical article URL. Stories are served in full to anonymous readers, so paywalled is never set.
GETapiKey2 credits/requestTheJournal.iepublicnews.articleResponseDoc
TheJournal.ie/thejournal/articleEndpoint facts
- Method
- GET
- API path
- /thejournal/article
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- TheJournal.ie
- Response schema
- #/definitions/publicnews.articleResponseDoc
How this endpoint behaves
Query parameter: url is a canonical HTTPS TheJournal.ie story URL on thejournal.ie or www.thejournal.ie, e.g. https://www.thejournal.ie/amazon-refunds-200-cheques-7170610-Sep2026/. A story path ends in a numeric story id and a month-year stamp. Section pages, topic pages, author pages, feed paths and sister-site (the42.ie) URLs return HTTP 400; an unknown story returns HTTP 404.
The endpoint returns public metadata (title, description, published_at, updated_at, section, authors, image_url) and the body paragraphs (paragraphs, list items and sub-heads; ad slots, pull quotes, related-story cards, newsletter sign-up boxes and the sponsor byline are not included). section is the story's label: a type such as Investigation, FactCheck or Column, or the lead topic tag such as Great News for an ordinary news story. Timestamps are converted from the site's Irish local time to UTC.
Paywall behavior: no story in the live sample (news, investigations, FactCheck, opinion and sister-site cross-posts, 2026-09-25) was gated; the full body is in the page an anonymous request receives. paywalled is therefore never set, and the endpoint never tries to bypass a gate.
Example response (truncated):
{"code":200,"data":{"url":"https://www.thejournal.ie/amazon-refunds-200-cheques-7170610-Sep2026","title":"Some Amazon customers will receive cheques for up to $200 following settlement with US regulators","description":"All future payments will be distributed automatically, eliminating the need for consumers to submit claims or additional paperwork to Amazon.","published_at":"2026-09-24T19:21:35Z","updated_at":"2026-09-24T19:21:35Z","section":"Great News","authors":["Ottoline Spearman"],"image_url":"https://img2.thejournal.ie/article/7170610/river/?height=400&version=7171290","paragraphs":["AMAZON CUSTOMERS MAY see cheques of up to $200 arrive in the post as part of a revised order following a $2.5 billion (€2.1 billion) settlement the tech company struck with US regulators last year."]}}
Sampled response
- Request, 14 Oct 2026
- GET /thejournal/article?url=https%3A%2F%2Fwww.thejournal.ie%2Famazon-refunds-200-cheques-7170610-Sep2026%2F
- Fields returned with a value
- 9
| Field | In the sample | Value in the sample |
|---|---|---|
| url | Has a value | thejournal.ie |
| title | Has a value | 97 characters |
| description | Has a value | 141 characters |
| published_at | Has a value | 2026-09-24 |
| updated_at | Has a value | 2026-09-24 |
| section | Has a value | “Great News” |
| authors | Has a value | 1 entry |
| image_url | Has a value | img2.thejournal.ie |
| paragraphs | Has a value | 11 entries |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical TheJournal.ie article URL | https://www.thejournal.ie/amazon-refunds-200-cheques-7170610-Sep2026/ | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/thejournal/article?url=https%3A%2F%2Fwww.thejournal.ie%2Famazon-refunds-200-cheques-7170610-Sep2026%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"url": "https://www.thejournal.ie/amazon-refunds-200-cheques-7170610-Sep2026",
"title": "Some Amazon customers will receive cheques for up to $200 following settlement with US regulators",
"description": "All future payments will be distributed automatically, eliminating the need for consumers to submit claims or additional paperwork to Amazon.",
"published_at": "2026-09-24T19:21:35Z",
"updated_at": "2026-09-24T19:21:35Z",
"section": "Great News",
"authors": [
"Ottoline Spearman"
],
"image_url": "https://img2.thejournal.ie/article/7170610/river/?height=400&version=7171290",
"paragraphs": [
"AMAZON CUSTOMERS MAY see cheques of up to $200 arrive in the post as part of a revised order following a $2.5 billion (€2.1 billion) settlement the tech company struck with US regulators last year."
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.articleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | 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 |
| 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/thejournal/article?url=https%3A%2F%2Fwww.thejournal.ie%2Famazon-refunds-200-cheques-7170610-Sep2026%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"