Docs menu
GMA News API endpoint
GMA News section headlines API
Returns up to 15 of the newest GMA News Online stories for one section, newest first. `section` is required and takes one of 44 slugs such as `topstories-world`, `money-economy`, `sports-nba` or `showbiz`. Each item has `title`, `url`, `summary`, `published_at` (UTC) and `image_url`. Quiet sections can return only a few items. An invalid or missing `section` returns 400.
GETapiKey1 credit/requestGMA Newspublicnews.headlinesResponseDoc
GMA News/gmanews/headlinesEndpoint facts
- Method
- GET
- API path
- /gmanews/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- GMA News
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of topstories, topstories-metro, topstories-nation, topstories-opinion, topstories-regions, topstories-specialreports, topstories-ulatfilipino, topstories-world, money, money-companies, money-economy, money-motoring, money-personalfinance, sports, sports-basketball, sports-boxing, sports-football, sports-nba, sports-othersports, sports-volleyball, showbiz, showbiz-chikaminute, showbiz-showbizabroad, lifestyle, lifestyle-artandculture, lifestyle-familyandrelationships, lifestyle-food, lifestyle-healthandwellness, lifestyle-hobbiesandactivities, lifestyle-shoppingandfashion, lifestyle-travel, scitech, scitech-science, scitech-technology, pinoyabroad, pinoyabroad-dispatch, pinoyabroad-pinoyachievers, serbisyopubliko, serbisyopubliko-missingpersons, serbisyopubliko-transportation, serbisyopubliko-walangpasok, cbb, publicaffairs, weather. Use gmanews-sections to list them with display names. Invalid or missing values return a 400 error. Returns up to 15 items per section, newest first, each with title, url, summary, published_at (UTC) and image_url. A few sections publish rarely (for example sports-nba currently lists a single item and serbisyopubliko-missingpersons has had no new item since April 2026), so short lists are normal there.
Sampled response
- Request, 14 Oct 2026
- GET /gmanews/headlines?section=topstories-world
- Items in items
- 15
- Fields filled in every checked item
- 5
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| title | 15 | median 68 characters |
| url | 15 | gmanetwork.com |
| summary | 15 | median 186 characters |
| published_at | 15 | 2026-10-12 to 2026-10-13 |
| image_url | 15 | images.gmanews.tv |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | GMA News section slug Allowed values: topstories, topstories-metro, topstories-nation, topstories-opinion, topstories-regions, topstories-specialreports, topstories-ulatfilipino, topstories-world, money, money-companies, money-economy, money-motoring, money-personalfinance, sports, sports-basketball, sports-boxing, sports-football, sports-nba, sports-othersports, sports-volleyball, showbiz, showbiz-chikaminute, showbiz-showbizabroad, lifestyle, lifestyle-artandculture, lifestyle-familyandrelationships, lifestyle-food, lifestyle-healthandwellness, lifestyle-hobbiesandactivities, lifestyle-shoppingandfashion, lifestyle-travel, scitech, scitech-science, scitech-technology, pinoyabroad, pinoyabroad-dispatch, pinoyabroad-pinoyachievers, serbisyopubliko, serbisyopubliko-missingpersons, serbisyopubliko-transportation, serbisyopubliko-walangpasok, cbb, publicaffairs, weather. | topstories | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/gmanews/headlines?section=topstories" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "topstories-world",
"items": [
{
"title": "Example headline",
"url": "https://www.gmanetwork.com/news/topstories/world/1003638/example-headline/story",
"published_at": "2026-09-24T20:03:23Z"
}
]
}
}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 GMA News 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/gmanews/headlines?section=topstories" \
-H "x-api-key: $CRAWLORA_API_KEY"