Skip to main content
GET
/
v1
/
runs
/
{runId}
/
content-suggestions
Get content suggestions
curl --request GET \
  --url https://api.example.com/v1/runs/{runId}/content-suggestions
{
  "run": {},
  "data": [
    {
      "prompt": {},
      "topic": {},
      "contentSuggestion": {}
    }
  ]
}

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.

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

​
runId
string
required
Run UUID. Obtain from List runs.

​
Query parameters

​
limit
integer
default:"20"
Items per page. Maximum 500.
​
page
integer
default:"1"
Page number (1-based).

​
Request

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"

​
Response

​
run
object
​
data
Suggestion[]
Array of content suggestions.
{
  "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 }
}