Docs menu
Phys.org API endpoint
Phys.org section headlines API
Returns current stories from one Phys.org feed. The accepted values are the seven Topics menu feeds plus the Breaking and Editorials feeds. Search and tag feeds are not included.
GETapiKey1 credit/requestPhys.orgpublicnews.headlinesResponseDoc
Phys.org/physorg/headlinesEndpoint facts
- Method
- GET
- API path
- /physorg/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Phys.org
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: required section, one of nanotech-news, physics-news, space-news, earth-news, chemistry-news, biology-news, science-news, breaking, or editorials. Use /api/v1/physorg/sections to discover these values.
Notable response behavior: returns stories from the selected public RSS feed. Invalid section values are rejected before an upstream request.
Workflow check
Start from the checked request: GET /physorg/headlines?section=physics-news. Live check on 2026-10-14: 30 items returned. Fields present in every checked item: title, url, summary, published_at.
Resolve a returned canonical story URL with Get a Phys.org article.
Live monitoring
- Monitored request
- GET /physorg/headlines?section=physics-news
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 1.76 s
Sampled response
- Request, 14 Oct 2026
- GET /physorg/headlines?section=physics-news
- Items in items
- 30
- Fields filled in every checked item
- 4
| Field | Filled in, of 30 checked | Values in the sample |
|---|---|---|
| title | 30 | median 82 characters |
| url | 30 | phys.org |
| summary | 30 | median 411 characters |
| published_at | 30 | 2026-10-08 to 2026-10-13 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Phys.org RSS feed slug from physorg-sections Allowed values: nanotech-news, physics-news, space-news, earth-news, chemistry-news, biology-news, science-news, breaking, editorials. | physics-news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/physorg/headlines?section=physics-news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Illustrative JSON response shape
{
"code": 200,
"data": {
"section": "physics-news",
"items": [
{
"title": "A physics headline",
"url": "https://phys.org/news/2026-09-example-story.html"
}
]
},
"msg": "OK"
}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 Phys.org latest science news 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/physorg/headlines?section=physics-news" \
-H "x-api-key: $CRAWLORA_API_KEY"