---
title: "GET /api/v1/radar"
method: GET
path: "/api/v1/radar"
tags: ["Composition"]
---

# GET /api/v1/radar

`GET /api/v1/radar`

## Request

- Base URL: `https://xquik.com`
- URL: `https://xquik.com/api/v1/radar`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns current topics and sources for writing research.

## Query parameters

- `after` string
- `category` 'general' | 'tech' | 'dev' | 'science' | 'culture' | 'politics' | 'business' | 'entertainment'
- `hours` integer
- `limit` integer
- `region` string
- `source` 'github' | 'google_trends' | 'hacker_news' | 'polymarket' | 'reddit' | 'trustmrr' | 'wikipedia'

## Response `200`

Radar items

- object
  - `hasMore` boolean, required
  - `items` RadarItem[], required
    - `id` string, required: Radar item identifier.
    - `sourceId` string, required: Source-specific identifier used for deduplication.
    - `title` string, required
    - `url` string
    - `score` number, required
    - `category` 'general' | 'tech' | 'dev' | 'science' | 'culture' | 'politics' | 'business' | 'entertainment', required
    - `source` 'github' | 'google_trends' | 'hacker_news' | 'polymarket' | 'reddit' | 'trustmrr' | 'wikipedia', required
    - `region` string, required
    - `language` string, required: BCP-47 language code. und means the source did not identify a language.
    - `metadata` object, required: Source fields vary. - reddit has author, authorId?, subreddit, subredditId?, subredditSubscribers?, sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?, numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?, postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?, editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?, isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?, isSelf?, isSpoiler?, isVideo?, locked? & stickied?. - github has starsToday. - hacker_news has points & numberComments. - google_trends has approxTraffic. - polymarket has volume24hr. - wikipedia has views. - trustmrr has mrr, growthPercent, last30Days, total, customers, activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?, foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?, multiple?, paymentProvider?, profitMarginLast30Days?, rank?, revenuePerVisitor?, targetAudience? & visitorsLast30Days?. Reddit score is public net. Vote estimates use its fuzzed ratio. Comments are omitted. Startup xHandle omits @. rank is its growth rank.
      - `author` string
      - `contentUrl` string, uri
      - `estimatedDownvotes` integer: Whole number from 0.
      - `estimatedUpvotes` integer: Whole number from 0.
      - `numberComments` integer: Whole number from 0.
      - `score` integer
      - `selftext` string
      - `sourceFormat` 'html' | 'json' | 'rss': Current items use html. json and rss remain on legacy rows.
      - `subreddit` string
      - `upvoteRatio` number
    - `publishedAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `description` string
    - `imageUrl` string: Source image. Startup growth items return the logo here.
  - `nextCursor` string: Opaque cursor for the next page (present only when hasMore is true).

## Other responses

- `400`: Invalid input. A value past its maxLength gets this answer, & the message names the field & its limit.
- `401`: Unauthenticated
- `429`: Too many requests right now. Each user gets 500 reads a second. Each minute allows 120 writes & 60 deletes. `x_api_rate_limited` means X limits this read for now. Neither answer costs anything. Wait for the seconds in `Retry-After`, then retry.
- `500`: Unexpected error.
- `default`: Unexpected error.

## Changes

- **2026-10-20** `45942c75fdc2`: 10 warning
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `400`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `401`
  - …6 more

[Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/radar/get.md)

---

[API](https://skmtc.dev/xquik-dev/apis/xquik-api.md) · [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api/revisions/45942c75fdc2?raw)