---
title: "Get a curated, AI-consumable feed of keyword trends."
method: POST
path: "/trends/discovery-feed"
tags: ["trends"]
---

# Get a curated, AI-consumable feed of keyword trends.

`POST /trends/discovery-feed`

## Request

- Base URL: `https://thieve.co/api/v1`
- URL: `https://thieve.co/api/v1/trends/discovery-feed`
- Auth: API key in header `api-key`

## Request body

- object
  - `labels` string[]
  - `limit` number
  - `minSearchVolume` number
  - `order` 'asc' | 'desc'
  - `page` number
  - `query` string
  - `sort` 'searchVolume' | 'opportunity' | 'momentumScore' | 'currentValue'

## Response `200`

Successful response

- object
  - `items` object[], required
    - `forecast13w` object[]
      - `lower` number, required
      - `mean` number, required
      - `upper` number, required
    - `keyword` string, required
    - `labels` string[], required
    - `scores` object, required
      - `confidence` number, required
      - `currentInterest` number, required
      - `investability` number, required
      - `momentum` number, required
      - `opportunity` number, required
      - `seasonality` number, required
      - `volatility` number, required
    - `searchVolume` number, required
    - `slug` string, required
    - `trendFlags` string[], required
    - `trendLabel` 'exploding' | 'exponential' | 'rising_fast' | 'rising' | 'stable' | 'declining' | 'crashing', required
  - `total` number, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

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