Radar
List radar items
Fetch free Radar trends with filters and cursor pagination
GET
List radar items
Free - does not consume credits
Headers
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.
Query parameters
Filter by Radar source identifier. Omit to return all available streams. Use the
source value returned on radar items when you need to poll one stream.Filter by category. One of:
general, tech, dev, science, culture, politics, business, entertainment. Omit to return all categories. Categories are assigned automatically based on source and content.Look-back window in hours. Range: 1-72. Smaller values surface the most recent trends; larger values give a broader snapshot. Default is 6 hours.
Items per page. Range: 1-100. Use smaller values (10-20) for quick polling, larger values for batch processing. Default is 50.
Region filter. Values:
US, GB, TR, ES, DE, FR, JP, IN, BR, CA, MX, global. Default global returns items from all regions.Cursor for pagination. Use the
nextCursor value from the previous response. Cursors are opaque base64 strings and should not be constructed manually.Response
Array of radar items sorted by score (descending).
Whether more items are available after this page.
Pagination cursor. Present only when
hasMore is true. Pass as the after query parameter on the next request.RadarItem fields
Radar item identifier.
Item title.
Item description. Omitted when unavailable.
Link to the original source. Omitted when unavailable.
Image URL. Omitted when unavailable.
Radar source identifier. Pass this value as the
source query parameter to filter future pages to the same stream.Unique identifier within the source.
One of:
general, tech, dev, science, culture, politics, business, entertainment.Region code (e.g.
US, TR, global).BCP-47 language code (e.g.
en, tr, ja).Relevance score (0-10,000). Higher is more trending.
Stream-specific data. Fields vary by item.
ISO 8601 timestamp of when the item was published or detected.
ISO 8601 timestamp of when the item was indexed.
Metadata
Themetadata object contains stream-specific fields. Common fields include:
| Field | Description |
|---|---|
author | Source author or publisher handle when available |
category | Additional stream category when available |
language | Language or programming language when available |
numberComments | Comment count when available |
points | Stream score or point count when available |
starsToday | Daily star count when available |
subreddit | Community identifier when available |
views | View count when available |
volume24hr | 24-hour volume when available |
Examples
- 200 OK
- 400 Invalid Input
- 401 Unauthenticated
- 429 Rate Limited
Pagination
Radar uses cursor-based pagination. WhenhasMore is true, pass the nextCursor value as the after query parameter to fetch the next page.
Next steps: Trends guide for content strategy workflows · Create Tweet to post about trending topics · Compose to generate AI-drafted tweets from radar items
Last modified on June 15, 2026
List radar items