List a keyword's stored AI answer runs
curl --request GET \
--url https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs \
--header 'x-api-key: <api-key>'import requests
url = "https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs', 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.nephia.cc/v1/keywords/{id}/ai-answers/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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.nephia.cc/v1/keywords/{id}/ai-answers/runs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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.nephia.cc/v1/keywords/{id}/ai-answers/runs")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"runs": [
{
"id": "<string>",
"keywordId": "<string>",
"engine": "chatgpt",
"model": "<string>",
"prompt": "<string>",
"country": "<string>",
"answerText": "<string>",
"truncated": true,
"searched": true,
"citations": [
{
"url": "<string>",
"domain": "<string>",
"title": "<string>"
}
],
"mentions": [
{
"term": "<string>",
"mentioned": true,
"cited": true,
"count": 123
}
],
"changed": "terms",
"previousRunId": "<string>",
"latencyMs": 123,
"askedAt": "<string>"
}
]
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "Rate limit exceeded",
"code": "TOO_MANY_REQUESTS"
}Keywords
List a keyword's stored AI answer runs
Every run the AI answers Source made for this keyword, newest first, including the runs that changed nothing and emitted no event, which is most of them and exactly what a trend is made of. Empty for a keyword that does not monitor AI answers. since defaults to the last 7 days; engine narrows to one engine. Free: it reads stored rows and asks no engine.
GET
/
v1
/
keywords
/
{id}
/
ai-answers
/
runs
List a keyword's stored AI answer runs
curl --request GET \
--url https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs \
--header 'x-api-key: <api-key>'import requests
url = "https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs', 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.nephia.cc/v1/keywords/{id}/ai-answers/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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.nephia.cc/v1/keywords/{id}/ai-answers/runs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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.nephia.cc/v1/keywords/{id}/ai-answers/runs")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nephia.cc/v1/keywords/{id}/ai-answers/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"runs": [
{
"id": "<string>",
"keywordId": "<string>",
"engine": "chatgpt",
"model": "<string>",
"prompt": "<string>",
"country": "<string>",
"answerText": "<string>",
"truncated": true,
"searched": true,
"citations": [
{
"url": "<string>",
"domain": "<string>",
"title": "<string>"
}
],
"mentions": [
{
"term": "<string>",
"mentioned": true,
"cited": true,
"count": 123
}
],
"changed": "terms",
"previousRunId": "<string>",
"latencyMs": 123,
"askedAt": "<string>"
}
]
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "Rate limit exceeded",
"code": "TOO_MANY_REQUESTS"
}Authorizations
API key created from the Nephia dashboard for your Account.
Path Parameters
Query Parameters
Available options:
chatgpt, gemini, perplexity Required range:
1 <= x <= 200Response
Stored runs
Show child attributes
Show child attributes
Was this page helpful?