> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-spotlight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get content suggestions

> Return AI-generated content ideas for a specific run.

Content suggestions are higher-level content ideas (article titles, descriptions, outlines) generated from a run. Use them to automatically populate content backlogs or feed ideas into editorial tools like Notion, Jira, or Trello.

### Path parameters

<ParamField path="runId" type="string" required>
  Run UUID. Obtain from [List runs](/api-reference/runs/list).
</ParamField>

### Query parameters

<ParamField query="limit" default="20" type="integer">
  Items per page. Maximum 500.
</ParamField>

<ParamField query="page" default="1" type="integer">
  Page number (1-based).
</ParamField>

### Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -s \
    -H "x-spotlight-api-key: YOUR_API_KEY" \
    "https://app.get-spotlight.com/api/v1/runs/RUN_ID/content-suggestions?limit=20&page=1"
  ```

  ```python Python theme={null}
  import requests

  r = requests.get(
      "https://app.get-spotlight.com/api/v1/runs/RUN_ID/content-suggestions",
      headers={"x-spotlight-api-key": "YOUR_API_KEY"},
      params={"limit": 20, "page": 1},
  )
  print(r.json())
  ```
</CodeGroup>

### Response

<ResponseField name="run" type="object">
  <Expandable title="Run" />
</ResponseField>

<ResponseField name="data" type="Suggestion[]">
  Array of content suggestions.

  <Expandable title="Suggestion object">
    <ResponseField name="prompt" type="object">
      <Expandable title="Prompt" />
    </ResponseField>

    <ResponseField name="topic" type="object">
      <Expandable title="Topic" />
    </ResponseField>

    <ResponseField name="contentSuggestion" type="object">
      <Expandable title="Content suggestion" />
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "run": { "id": "run-uuid-123", "brandId": "brand-uuid-123", "startedAt": "2025-02-01T10:00:00Z" },
  "data": [
    {
      "id": "suggestion-uuid-1",
      "runId": "run-uuid-123",
      "prompt": { "text": "What do customers say about our onboarding?", "estimatedVolume": 120 },
      "topic": { "name": "Onboarding experience" },
      "llms": ["chatgpt"],
      "contentSuggestion": {
        "title": "Guide: Make your first week with us effortless",
        "description": "A step-by-step onboarding guide that addresses the most common friction points."
      }
    }
  ],
  "paging": { "page": 1, "limit": 20, "total": 5, "nextPage": null }
}
```