Docs menu
Space API endpoint
Space.com section headlines API
Returns the latest Space.com stories for one category. `section` is required and takes a slug from `space-sections`, which joins nested category paths with hyphens, such as `astronomy`, `astronomy-solar-system-mars` or `stargazing-meteor-showers`. Each item has its title, URL, summary, author, publication time and image. Other values return a 400.
GETapiKey1 credit/requestSpacepublicnews.headlinesResponseDoc
Space/space/headlinesEndpoint facts
- Method
- GET
- API path
- /space/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Space
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of the slugs returned by space-sections: astronomy, astronomy-black-holes, astronomy-dark-universe, astronomy-exoplanets, astronomy-galaxies, astronomy-hubble-space-telescope, astronomy-james-webb-space-telescope, astronomy-solar-system, astronomy-solar-system-asteroids, astronomy-solar-system-comets, astronomy-solar-system-dwarf-planets, astronomy-solar-system-earth, astronomy-solar-system-jupiter, astronomy-solar-system-mars, astronomy-solar-system-mercury, astronomy-solar-system-moon, astronomy-solar-system-neptune, astronomy-solar-system-pluto, astronomy-solar-system-saturn, astronomy-solar-system-sun, astronomy-solar-system-uranus, astronomy-solar-system-venus, astronomy-stars, entertainment, entertainment-space-books, entertainment-space-games, entertainment-space-movies-shows, entertainment-space-toys-lego, science, science-astrophysics, science-climate-change, science-particle-physics, science-weather, space-exploration, space-exploration-human-spaceflight, space-exploration-launches-spacecraft, space-exploration-missions, space-exploration-missions-apollo, space-exploration-missions-artemis, space-exploration-missions-asteroid-comet-missions, space-exploration-missions-international-space-station, space-exploration-missions-mars-rovers, space-exploration-missions-new-horizons, space-exploration-missions-parker-solar-probe, space-exploration-missions-space-shuttle, space-exploration-missions-voyager, space-exploration-private-spaceflight, space-exploration-satellites, space-exploration-search-for-life, stargazing, stargazing-astrophotography, stargazing-auroras, stargazing-constellations, stargazing-eclipses, stargazing-eclipses-lunar-eclipses, stargazing-eclipses-solar-eclipses, stargazing-meteor-showers, stargazing-skywatching-kit, technology, technology-aerospace, or technology-drones. Any other value is rejected with a 400.
Sampled response
- Request, 14 Oct 2026
- GET /space/headlines?section=astronomy
- Items in items
- 10
- Fields filled in every checked item
- 6
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| title | 10 | median 80 characters |
| url | 10 | space.com |
| summary | 10 | median 128 characters |
| published_at | 10 | 2026-10-08 to 2026-10-13 |
| author | 10 | |
| image_url | 10 | cdn.mos.cms.futurecdn.net |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Space.com category slug Allowed values: astronomy, astronomy-black-holes, astronomy-dark-universe, astronomy-exoplanets, astronomy-galaxies, astronomy-hubble-space-telescope, astronomy-james-webb-space-telescope, astronomy-solar-system, astronomy-solar-system-asteroids, astronomy-solar-system-comets, astronomy-solar-system-dwarf-planets, astronomy-solar-system-earth, astronomy-solar-system-jupiter, astronomy-solar-system-mars, astronomy-solar-system-mercury, astronomy-solar-system-moon, astronomy-solar-system-neptune, astronomy-solar-system-pluto, astronomy-solar-system-saturn, astronomy-solar-system-sun, astronomy-solar-system-uranus, astronomy-solar-system-venus, astronomy-stars, entertainment, entertainment-space-books, entertainment-space-games, entertainment-space-movies-shows, entertainment-space-toys-lego, science, science-astrophysics, science-climate-change, science-particle-physics, science-weather, space-exploration, space-exploration-human-spaceflight, space-exploration-launches-spacecraft, space-exploration-missions, space-exploration-missions-apollo, space-exploration-missions-artemis, space-exploration-missions-asteroid-comet-missions, space-exploration-missions-international-space-station, space-exploration-missions-mars-rovers, space-exploration-missions-new-horizons, space-exploration-missions-parker-solar-probe, space-exploration-missions-space-shuttle, space-exploration-missions-voyager, space-exploration-private-spaceflight, space-exploration-satellites, space-exploration-search-for-life, stargazing, stargazing-astrophotography, stargazing-auroras, stargazing-constellations, stargazing-eclipses, stargazing-eclipses-lunar-eclipses, stargazing-eclipses-solar-eclipses, stargazing-meteor-showers, stargazing-skywatching-kit, technology, technology-aerospace, technology-drones. | astronomy | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/space/headlines?section=astronomy" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "astronomy",
"items": [
{
"title": "Example astronomy headline",
"url": "https://www.space.com/astronomy/example-story",
"summary": "Example summary.",
"author": "Example Author",
"published_at": "2026-09-23T16:00:00Z",
"image_url": "https://cdn.mos.cms.futurecdn.net/example.jpg"
}
]
}
}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 Space.com 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/space/headlines?section=astronomy" \
-H "x-api-key: $CRAWLORA_API_KEY"