Docs menu
The Japan Times API endpoint
The Japan Times top stories API
Returns the current top stories from The Japan Times. It takes no parameters. Each item has its title, URL, publication time and a short publisher-written teaser in `summary`, not the article text, plus the author and image when the outlet provides them.
GETapiKey1 credit/requestThe Japan Timespublicnews.newsResponseDoc
The Japan Times/japantimes/newsEndpoint facts
- Method
- GET
- API path
- /japantimes/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- The Japan Times
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns up to the publisher's current top stories from its public RSS feed. RSS supplies headlines and short publisher-provided teaser descriptions, not full article text.
Workflow check
Start from the checked request: GET /japantimes/news. Live check on 2026-10-14: 30 items returned. Fields present in every checked item: title, url, summary, published_at, image_url.
Resolve a returned canonical story URL with Get a The Japan Times article.
Live monitoring
- Monitored request
- GET /japantimes/news
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 2.35 s
Sampled response
- Request, 14 Oct 2026
- GET /japantimes/news
- Items in items
- 30
- Fields filled in every checked item
- 5
| Field | Filled in, of 30 checked | Values in the sample |
|---|---|---|
| title | 30 | median 59 characters |
| url | 30 | japantimes.co.jp |
| summary | 30 | median 139 characters |
| published_at | 30 | 2026-10-14 |
| image_url | 30 | japantimes.co.jp |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/japantimes/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Illustrative JSON response shape
{
"code": 200,
"data": {
"items": [
{
"title": "Example headline",
"url": "https://www.japantimes.co.jp/news/2026/09/29/japan/example-story/",
"summary": "Short publisher-provided teaser."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.NewsResponse | No | ||||
| data.items | array | No | ||||
| data.items[].author | string | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].summary | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].type | string | No | ||||
| data.items[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 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/japantimes/news" \
-H "x-api-key: $CRAWLORA_API_KEY"