---
title: "Get Content Ideas Public"
method: GET
path: "/get-content-ideas"
tags: ["public-api"]
---

# Get Content Ideas Public

`GET /get-content-ideas`

## Request

- Base URL: `https://api.trakkr.ai`
- URL: `https://api.trakkr.ai/get-content-ideas`
- Auth: HTTP bearer

List AI-generated content gap opportunities for a brand.

Returns content ideas ranked by opportunity score, with optional status filtering.
Ideas are generated periodically by Trakkr's analysis engine.

## Query parameters

- `brand_id` string, uuid, required: Brand UUID
- `limit` integer: Results per page
- `offset` integer: Pagination offset
- `status` 'active' | 'dismissed' | 'implemented', nullable: Filter by status

## Response `200`

Successful Response

- ContentIdeasPublicResponse: GET /content-ideas response.
  - `ideas` ContentIdeaPublicItem[], required
    - `id` string, required
    - `type` string, required
    - `query` string, required
    - `insight` string, nullable
    - `opportunity_score` integer
    - `status` string
    - `recommended_template` string, nullable
    - `competitors_appearing` string[]
    - `ai_models` string[]
    - `your_position` integer, nullable
    - `created_at` string, required
    - `potential` string, nullable
    - `angle` string, nullable
    - `why_now` string, nullable
    - `sub_questions` string[]
    - `proof_points` string[]
    - `competitors_winning` string[]
    - `is_quick_win` boolean
  - `pagination` PaginationInfo, required: Pagination metadata.
    - `total` integer, required
    - `limit` integer, required
    - `offset` integer, required
    - `has_more` boolean, required
  - `meta` ContentIdeasMeta, required: Metadata about content ideas generation.
    - `generated_at` string, nullable
    - `generation_status` string, nullable
    - `total_opportunities` integer

## Other responses

- `401`: Missing, malformed, or expired credentials
- `402`: The current plan does not fund this operation
- `403`: Invalid credentials, missing brand access, or insufficient role
- `422`: Validation Error
- `429`: Rate limit exceeded
- `500`: The operation failed
- `503`: Authentication, entitlement, or a required dependency is temporarily unavailable

---

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