Content Suggestions
Get content suggestions
Return AI-generated content ideas for a specific run.
GET
/
v1
/
runs
/
{runId}
/
content-suggestions
Get content suggestions
curl --request GET \
--url https://api.example.com/v1/runs/{runId}/content-suggestionsimport requests
url = "https://api.example.com/v1/runs/{runId}/content-suggestions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/runs/{runId}/content-suggestions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/runs/{runId}/content-suggestions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/runs/{runId}/content-suggestions"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/runs/{runId}/content-suggestions")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/runs/{runId}/content-suggestions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"run": {},
"data": [
{
"prompt": {},
"topic": {},
"contentSuggestion": {}
}
]
}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
Query parameters
Items per page. Maximum 500.
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"
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())
Response
Show Run
Show Run
{
"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 }
}
Previous
Get latest content suggestionsReturn content suggestions from the most recent run of a brand.
Next
⌘I
Get content suggestions
curl --request GET \
--url https://api.example.com/v1/runs/{runId}/content-suggestionsimport requests
url = "https://api.example.com/v1/runs/{runId}/content-suggestions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/runs/{runId}/content-suggestions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/runs/{runId}/content-suggestions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/runs/{runId}/content-suggestions"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/runs/{runId}/content-suggestions")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/runs/{runId}/content-suggestions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"run": {},
"data": [
{
"prompt": {},
"topic": {},
"contentSuggestion": {}
}
]
}