Get a content idea search
curl --request GET \
--url https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}"
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}', 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}",
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}"
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}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}")
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{
"createdAt": "<string>",
"id": "<string>",
"keyword": "<string>",
"nbContentIdeas": 123,
"searchVolume": 123,
"status": "pending"
}Content Ideas
Get a content idea search
Returns a content idea search and its processing status (pending → success / failed). Use it to poll an asynchronous search started with POST.
GET
/
v1
/
content-idea-searches
/
{contentIdeaSearchId}
Get a content idea search
curl --request GET \
--url https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}"
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}', 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}",
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}"
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}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/content-idea-searches/{contentIdeaSearchId}")
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{
"createdAt": "<string>",
"id": "<string>",
"keyword": "<string>",
"nbContentIdeas": 123,
"searchVolume": 123,
"status": "pending"
}Authorizations
API key starting with sk_. Generate one in Settings > API Keys.
Path Parameters
Content idea search ID.
Response
200 - application/json
Default Response
ISO 8601 creation date.
Unique identifier of the content idea search.
Seed keyword the search was run on.
Number of content ideas found by the search.
Monthly search volume of the seed keyword.
Processing status of the asynchronous search (pending → success / failed).
Available options:
pending, success, failed Was this page helpful?