---
title: "List Movers By Category"
method: GET
path: "/api/v1/news/movers/by-category"
tags: ["news"]
---

# List Movers By Category

`GET /api/v1/news/movers/by-category`

## Request

- Base URL: `https://api.pdata.world`
- URL: `https://api.pdata.world/api/v1/news/movers/by-category`
- Auth: none declared

Use when the user wants the news feed bucketed by category. Returns the same data shape as `list_news_movers` but pre-grouped into the canonical 14-category vocabulary, with cluster grouping inside each bucket. Useful for 'what's moving in politics?' style queries.

## Query parameters

- `source` string, nullable: Platform ID(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.
- `q` string, nullable: Full-text search across market title and event title. Case-insensitive substring match.
- `min_score` number, nullable: Minimum spike score. Higher = more notable spikes only.
- `include_entertainment` boolean: Include entertainment markets (default: excluded for signal-to-noise).
- `include_microprediction` boolean: Include microprediction / hyperlocal markets (default: excluded).
- `include_crypto` boolean: Include crypto price-derivative markets (default: excluded).
- `include_sports` boolean: Include sports markets (default: excluded).
- `include_weather` boolean: Include weather markets (default: excluded).
- `include_resolved` boolean: Include resolved (closed) markets (default: excluded — news movers focus on live markets).
- `per_category` integer: Max items per category bucket (1-50; default 11).

## Response `200`

Successful Response

- NewsByCategoryResponse: Response for GET /api/v1/news/movers/by-category. The same event/cluster can appear in multiple buckets when its categories list contains more than one entry. Bucket keys match v2's `KNOWN_CATEGORIES`; bucket values are sorted by score desc and capped at the per-category limit (`?per_category=`, default 11).
  - `last_refreshed_at` string, date-time, nullable, required
  - `by_category` object, required
  - `_meta` ResponseMetaList: Agent metadata for list/aggregate responses (no cite_as).
    - `attribution` string: Who aggregated this data, under which licence, and whose data it is.
    - `canonical_url` string, required: Stable URL for this resource: the pdata.world page, or the API URL for list responses.
    - `as_of` string, date-time: When this response was generated (UTC).
    - `docs` string: API documentation.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pdata/apis/pdata-backend.md) · [All operations](https://skmtc.dev/pdata/apis/pdata-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/pdata/apis/pdata-backend/revisions/4c9bf3856786?raw)