Skip to main content
GET
/
radar
List radar items
curl --request GET \
  --url https://xquik.com/api/v1/radar \
  --header 'x-api-key: <api-key>'
{
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

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. Radar is authenticated but free. It does not require an active subscription and does not consume credits.

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

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
Radar 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)
trustmrrAlways present: mrr (number, monthly recurring revenue in USD), growthPercent (number, 30-day growth clamped to -99..999), last30Days (number, USD revenue over trailing 30 days), total (number, aggregate USD revenue since tracking began), customers (number), activeSubscriptions (number), onSale (boolean). Optional: xHandle (string), category (string), askingPrice (number, USD, only when onSale is true), country (string, ISO-3166-1 alpha-2), growthMrrPercent (number, 30-day MRR growth clamped to -99..999), multiple (number, revenue multiple up to 2 decimals), paymentProvider (string), rank (integer, rank within TrustMRR dashboard).

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
Last modified on May 6, 2026