---
title: "Search subreddits (live)"
method: GET
path: "/api/data/reddit/subreddits/live"
tags: ["Reddit (live)"]
---

# Search subreddits (live)

`GET /api/data/reddit/subreddits/live`

## Request

- Base URL: `https://api.xpoz.ai`
- URL: `https://api.xpoz.ai/api/data/reddit/subreddits/live`
- Auth: HTTP bearer

Search subreddits by keyword on demand. Fetches directly from the platform and returns one page with a cursor. Not available for trial access keys.

## Query parameters

- `q` string, required
- `fields` string[]
- `limit` integer
- `cursor` string

## Response `200`

One page of results.

- CursorResponse: Envelope for on-demand `/live` endpoints: one provider page plus a cursor.
  - `results` object[], required
  - `count` integer, required
  - `dataSource` 'database' | 'api' | 'hybrid', required: Where the results came from.
  - `has_more` boolean, required
  - `next_page_cursor` string, nullable, required

## Other responses

- `400`: Validation failed.
- `401`: Missing or invalid credentials.
- `403`: On-demand search is not available for trial access keys.
- `default`: The request could not be fulfilled. Status is 400 for an empty or invalid search query, 402 when CSV export is blocked by plan limits, 500 otherwise.

---

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