Docs menu
MLive API endpoint
MLive top stories API
Returns current MLive top stories, including title, canonical URL, brief summary, author, publication time, and image where available. Article pages are not currently available, and category endpoints are deferred.
GETapiKey1 credit/requestMLivepublicnews.newsResponseDoc
MLive/mlive/newsEndpoint facts
- Method
- GET
- API path
- /mlive/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- MLive
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns current top stories from MLive's anonymous Arc RSS feed. Each item includes its title, canonical URL, short summary, byline and publication time; an image is included when present. This is a listing endpoint: the feed's encoded content is inconsistent and may contain only a brief teaser, so it is not an article-body source. No query parameters are accepted.
Workflow check
Start from the checked request: GET /mlive/news. Live check on 2026-10-14: 50 items returned. Fields present in every checked item: title, url, summary, published_at, author, image_url.
Sampled response
- Request, 14 Oct 2026
- GET /mlive/news
- Items in items
- 50
- Fields filled in every checked item
- 6
| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| title | 50 | median 72 characters |
| url | 50 | mlive.com |
| summary | 50 | median 122 characters |
| published_at | 50 | 2026-10-13 to 2026-10-14 |
| author | 50 | |
| image_url | 50 | mlive.com |
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/mlive/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Illustrative JSON response shape
{
"code": 200,
"data": {
"items": [
{
"title": "A rural Michigan town lost its hospital. The impact goes beyond healthcare.",
"url": "https://www.mlive.com/news/kalamazoo/2026/09/a-rural-michigan-town-lost-its-hospital-the-impact-goes-beyond-healthcare.html",
"summary": "A rural hospital closed, giving three-days notice. A Michigan town is living with the consequences.",
"published_at": "2026-09-28T10:45:00Z",
"author": "Julie Riddle",
"image_url": "https://www.mlive.com/resizer/v2/example.jpg"
}
]
}
}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 |
|---|---|---|
| 429 | Too Many Requests | #/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/mlive/news" \
-H "x-api-key: $CRAWLORA_API_KEY"