Docs menu
PhoneArena API endpoint
PhoneArena section headlines API
Returns up to 100 newest PhoneArena stories or reviews from one public listing. For news-month and reviews, titles are reconstructed from the hero-image file name and published_at is the listing's last-modified time.
GETapiKey1 credit/requestPhoneArenapublicnews.headlinesResponseDoc
PhoneArena/phonearena/headlinesEndpoint facts
- Method
- GET
- API path
- /phonearena/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- PhoneArena
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of news, news-month, reviews. Use phonearena-sections to list them with display names. Invalid values return a 400 error.
Returns up to 100 of the newest stories for the listing, newest first. Each item has a title, canonical url, type (news or review), published_at and a hero image_url.
news: exact titles and publication times.news-monthandreviews: PhoneArena's sitemaps for these carry no titles or publication times, sotitleis reconstructed from the hero-image file name (capitalization is preserved but punctuation such as colons, apostrophes and commas is dropped) andpublished_atis the sitemap's last-modified time, which can be later than the original publication time. Usephonearena-articlefor the exact title and publication time.
Sampled response
- Request, 14 Oct 2026
- GET /phonearena/headlines?section=reviews
- Items in items
- 100
- Fields filled in every checked item
- 5
| Field | Filled in, of 100 checked | Values in the sample |
|---|---|---|
| title | 100 | median 62 characters |
| url | 100 | phonearena.com |
| type | 100 | review in all 100 |
| published_at | 100 | 2026-02-25 to 2026-10-13 |
| image_url | 100 | m-cdn.phonearena.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | PhoneArena listing slug Allowed values: news, news-month, reviews. | news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/phonearena/headlines?section=news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "reviews",
"items": [
{
"title": "iPhone 18 Pro Review Battery life and new photographic styles are the stand out upgrades",
"url": "https://www.phonearena.com/reviews/iphone-18-pro-review_id8043",
"type": "review",
"published_at": "2026-09-24T12:34:55Z",
"image_url": "https://m-cdn.phonearena.com/images/review/8043-wide-two/iPhone-18-Pro-Review.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 PhoneArena 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/phonearena/headlines?section=news" \
-H "x-api-key: $CRAWLORA_API_KEY"