Docs menu
The Japan Times API endpoint
The Japan Times section headlines API
Returns public article cards from one canonical section page. This site's section pages are HTML; only the top stories surface has a verified RSS feed.
GETapiKey1 credit/requestThe Japan Timespublicnews.headlinesResponseDoc
The Japan Times/japantimes/headlinesEndpoint facts
- Method
- GET
- API path
- /japantimes/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- The Japan Times
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of news-japan, news-japan-politics, news-japan-society, news-japan-crime-legal, news-japan-science-health, news-japan-explainer, news-japan-history, news-world, news-world-politics, news-world-crime-legal, news-world-science-health, news-world-society, news-asia-pacific, news-asia-pacific-politics, news-asia-pacific-crime-legal, news-asia-pacific-science-health, news-asia-pacific-society, business, business-companies, business-economy, business-markets, business-tech, sports, sports-sumo, sports-soccer, sports-baseball, sports-basketball, sports-tennis, sports-olympics, sports-more-sports, opinion, opinion-editorials, opinion-commentary, tag-geoeconomic-briefing, environment, environment-climate-change, environment-energy, environment-sustainability, environment-wildlife, environment-earth-science, life, life-travel, life-digital, life-food-drink, life-style-design, life-language, life-lifestyle, culture, culture-film, culture-books, culture-music, culture-art, culture-tv-streaming, culture-stage, culture-entertainment-news, community, community-voices, community-issues, community-how-tos, community-our-lives. The API fetches the canonical section page from the navigation inventory and returns its public article cards. The publisher has no verified section RSS route; the main RSS feed is only used by japantimes-news.
Workflow check
Start from the checked request: GET /japantimes/headlines?section=environment. Live check on 2026-10-14: 56 items returned. Fields present in every checked item: title, url.
Resolve a returned canonical story URL with Get a The Japan Times article.
Live monitoring
- Monitored request
- GET /japantimes/headlines?section=environment
- Checks passed, 7 days to 14 Oct 2026
- 99.7%
- Median response time
- 4.75 s
Sampled response
- Request, 14 Oct 2026
- GET /japantimes/headlines?section=environment
- Items in items
- 56
- Fields filled in every checked item
- 2
| Field | Filled in, of 56 checked | Values in the sample |
|---|---|---|
| title | 56 | median 64 characters |
| url | 56 | japantimes.co.jp |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Canonical section slug from japantimes-sections Allowed values: news-japan, news-japan-politics, news-japan-society, news-japan-crime-legal, news-japan-science-health, news-japan-explainer, news-japan-history, news-world, news-world-politics, news-world-crime-legal, news-world-science-health, news-world-society, news-asia-pacific, news-asia-pacific-politics, news-asia-pacific-crime-legal, news-asia-pacific-science-health, news-asia-pacific-society, business, business-companies, business-economy, business-markets, business-tech, sports, sports-sumo, sports-soccer, sports-baseball, sports-basketball, sports-tennis, sports-olympics, sports-more-sports, opinion, opinion-editorials, opinion-commentary, tag-geoeconomic-briefing, environment, environment-climate-change, environment-energy, environment-sustainability, environment-wildlife, environment-earth-science, life, life-travel, life-digital, life-food-drink, life-style-design, life-language, life-lifestyle, culture, culture-film, culture-books, culture-music, culture-art, culture-tv-streaming, culture-stage, culture-entertainment-news, community, community-voices, community-issues, community-how-tos, community-our-lives. | environment | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/japantimes/headlines?section=environment" \ -H "x-api-key: $CRAWLORA_API_KEY"
Illustrative JSON response shape
{
"code": 200,
"data": {
"section": "news-japan",
"items": [
{
"title": "Example headline",
"url": "https://www.japantimes.co.jp/news/2026/09/29/japan/example-story/"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under The Japan Times top stories API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/japantimes/headlines?section=environment" \
-H "x-api-key: $CRAWLORA_API_KEY"