curl --request GET \
--url https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas', 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/content-idea-searches/{contentIdeaSearchId}/content-ideas",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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/content-idea-searches/{contentIdeaSearchId}/content-ideas"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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/content-idea-searches/{contentIdeaSearchId}/content-ideas")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"clusterIds": [
"<string>"
],
"id": "<string>",
"isQuestion": true,
"keyword": "<string>",
"keywordBrand": "<string>",
"keywordDifficulty": 123,
"relevance": 123,
"searchVolume": 123,
"similarityScore": 123,
"title": "<string>",
"type": "<string>",
"url": "<string>",
"urlCategory": "<string>",
"urlEstimatedTraffic": 123,
"urlWordsCount": 123,
"workspaceUrlPosition": 123,
"workspaceUrlRanked": "<string>"
}
],
"pagination": {
"hasMore": true,
"limit": 123,
"page": 123,
"total": 123
}
}List content ideas of a search
Returns a paginated list of the content ideas produced by a completed search. Each idea carries its keyword, URL, search volume, keyword difficulty, estimated traffic, relevance and the workspace’s own ranking on the keyword. Supports filtering (keyword, title, url, type, keywordBrand, and gte/lte ranges on searchVolume, keywordDifficulty, urlEstimatedTraffic, similarityScore) and sorting.
curl --request GET \
--url https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas', 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/content-idea-searches/{contentIdeaSearchId}/content-ideas",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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/content-idea-searches/{contentIdeaSearchId}/content-ideas"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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/content-idea-searches/{contentIdeaSearchId}/content-ideas")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}/content-ideas")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"clusterIds": [
"<string>"
],
"id": "<string>",
"isQuestion": true,
"keyword": "<string>",
"keywordBrand": "<string>",
"keywordDifficulty": 123,
"relevance": 123,
"searchVolume": 123,
"similarityScore": 123,
"title": "<string>",
"type": "<string>",
"url": "<string>",
"urlCategory": "<string>",
"urlEstimatedTraffic": 123,
"urlWordsCount": 123,
"workspaceUrlPosition": 123,
"workspaceUrlRanked": "<string>"
}
],
"pagination": {
"hasMore": true,
"limit": 123,
"page": 123,
"total": 123
}
}Authorizations
API key starting with sk_. Generate one in Settings > API Keys.
Path Parameters
Content idea search ID.
Query Parameters
1 <= x <= 100x >= 1Filter by exact keyword.
Filter by keyword substring.
Filter by keyword brandedness (exact).
Keyword difficulty >= (0-100).
0 <= x <= 100Keyword difficulty <= (0-100).
0 <= x <= 100Monthly search volume >=.
x >= 0Monthly search volume <=.
x >= 0Similarity score >=.
Similarity score <=.
Sort field, prefix with - for descending. Default: by relevance (similarity score, descending).
searchVolume, -searchVolume, title, -title, type, -type, urlEstimatedTraffic, -urlEstimatedTraffic Filter by exact URL title.
Filter by URL title substring.
Filter by idea type.
related, broadmatch Filter by exact URL.
Filter by URL substring.
URL estimated monthly traffic >=.
x >= 0URL estimated monthly traffic <=.
x >= 0Was this page helpful?