Skip to main content
GET
/
radar
List radar items
curl --request GET \
  --url https://api.example.com/radar
{
  "items": [
    {}
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "url": "<string>",
  "imageUrl": "<string>",
  "source": "<string>",
  "sourceId": "<string>",
  "category": "<string>",
  "region": "<string>",
  "language": "<string>",
  "score": 123,
  "metadata": {},
  "publishedAt": "<string>",
  "createdAt": "<string>"
}
Free — does not consume credits
Get trending topics and news aggregated from 7 sources: Google Trends, Hacker News, Polymarket, TrustMRR, Wikipedia, GitHub Trending, and Reddit. Filter by source, category, region, and time window. Free for all subscribers. No usage cost.

​
Query parameters

​
source
string
Filter by source. One of: google_trends, hacker_news, polymarket, trustmrr, wikipedia, github, reddit. Omit to return items from all 7 sources combined. Use this to focus on a single data stream (e.g. github for developer-focused trends).
​
category
string
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.
​
hours
integer
default:"6"
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.
​
limit
integer
default:"50"
Items per page. Range: 1-100. Use smaller values (10-20) for quick polling, larger values for batch processing. Default is 50.
​
region
string
default:"global"
Region filter. Values: US, GB, TR, ES, DE, FR, JP, IN, BR, CA, MX, global. Default global returns items from all regions. Region filtering is most useful with google_trends and reddit sources.
​
after
string
Cursor for pagination. Use the nextCursor value from the previous response. Cursors are opaque base64 strings and should not be constructed manually.

​
Response

​
items
RadarItem[]
required
Array of radar items sorted by score (descending).
​
hasMore
boolean
required
Whether more items are available after this page.
​
nextCursor
string
Pagination cursor. Present only when hasMore is true. Pass as the after query parameter on the next request.

​
RadarItem fields

​
id
string
required
Unique item identifier.
​
title
string
required
Item title.
​
description
string
Item description. Omitted when unavailable.
​
url
string
Link to the original source. Omitted when unavailable.
​
imageUrl
string
Image URL. Omitted when unavailable.
​
source
string
required
One of: google_trends, hacker_news, polymarket, trustmrr, wikipedia, github, reddit.
​
sourceId
string
required
Unique identifier within the source.
​
category
string
required
One of: general, tech, dev, science, culture, politics, business, entertainment.
​
region
string
required
Region code (e.g. US, TR, global).
​
language
string
required
BCP-47 language code (e.g. en, tr, ja).
​
score
integer
required
Relevance score (0-10,000). Higher is more trending.
​
metadata
object
required
Source-specific data. Fields vary by source (see below).
​
publishedAt
string
required
ISO 8601 timestamp of when the item was published or detected.
​
createdAt
string
required
ISO 8601 timestamp of when the item was indexed.

​
Source-Specific Metadata

Each source includes different fields in the metadata object:
SourceMetadata Fields
githubstarsToday (number), language (string, programming language)
hacker_newspoints (number), numberComments (number), author (string)
redditsubreddit (string), author (string)
google_trendsapproxTraffic (number, approximate search volume)
wikipediaviews (number, page views)
polymarketvolume24hr (number, 24-hour trading volume), liquidity (number), outcomes (array of outcome objects)
trustmrrmrr (number, monthly revenue in dollars), growthPercent (number), last30Days (number), customers (number), activeSubscriptions (number), onSale (boolean), category (string), xHandle (string)

​
Examples

curl "https://xquik.com/api/v1/radar?source=hacker_news&hours=12&limit=10" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
Response: 
{
  "items": [
    {
      "id": "12345",
      "title": "Show HN: Open-source alternative to Vercel",
      "description": "A self-hosted deployment platform with preview environments and edge functions.",
      "url": "https://news.ycombinator.com/item?id=12345",
      "source": "hacker_news",
      "sourceId": "hn_12345",
      "category": "tech",
      "region": "global",
      "language": "en",
      "score": 450,
      "metadata": {
        "points": 450,
        "numberComments": 132,
        "author": "pgdev"
      },
      "publishedAt": "2026-03-04T08:30:00.000Z",
      "createdAt": "2026-03-04T08:35:00.000Z"
    },
    {
      "id": "67890",
      "title": "typescript-go",
      "description": "TypeScript compiler rewritten in Go for 10x faster builds.",
      "url": "https://github.com/nicolo-ribaudo/typescript-go",
      "source": "github",
      "sourceId": "gh_67890",
      "category": "dev",
      "region": "global",
      "language": "en",
      "score": 1200,
      "metadata": {
        "starsToday": 1200,
        "language": "Go"
      },
      "publishedAt": "2026-03-04T06:00:00.000Z",
      "createdAt": "2026-03-04T06:05:00.000Z"
    },
    {
      "id": "24680",
      "title": "AI regulation bill passes Senate committee",
      "url": "https://www.reddit.com/r/technology/comments/abc123",
      "source": "reddit",
      "sourceId": "reddit_24680",
      "category": "politics",
      "region": "US",
      "language": "en",
      "score": 320,
      "metadata": {
        "subreddit": "technology",
        "author": "policy_watcher"
      },
      "publishedAt": "2026-03-04T10:15:00.000Z",
      "createdAt": "2026-03-04T10:20:00.000Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "NDUwfDIwMjYtMDMtMDRUMDg6MzA6MDAuMDAwWnwxMjM0NQ=="
}

​
Pagination

Radar uses cursor-based pagination. When hasMore is true, pass the nextCursor value as the after query parameter to fetch the next page. 
# First page
curl "https://xquik.com/api/v1/radar?limit=20" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

# Next page
curl "https://xquik.com/api/v1/radar?limit=20&after=NDUwfDIwMjYtMDMtMDRUMDg6MzA6MDAuMDAwWnwxMjM0NQ==" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
Next steps: Trends guide for content strategy workflows · Create Tweet to post about trending topics · Compose to generate AI-drafted tweets from radar items