Détail des citations par prompt et contenu
curl --request POST \
--url https://api.athenahq.ai/api/v1/content/prompts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"content_id": "11111111-2222-3333-4444-555555555555",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
}
}
'import requests
url = "https://api.athenahq.ai/api/v1/content/prompts"
payload = {
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"content_id": "11111111-2222-3333-4444-555555555555",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
website_id: '123e4567-e89b-12d3-a456-426614174000',
content_id: '11111111-2222-3333-4444-555555555555',
filters: {start_date: '2024-01-01T00:00:00.000Z', end_date: '2024-01-31T23:59:59.999Z'}
})
};
fetch('https://api.athenahq.ai/api/v1/content/prompts', 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.athenahq.ai/api/v1/content/prompts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'website_id' => '123e4567-e89b-12d3-a456-426614174000',
'content_id' => '11111111-2222-3333-4444-555555555555',
'filters' => [
'start_date' => '2024-01-01T00:00:00.000Z',
'end_date' => '2024-01-31T23:59:59.999Z'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.athenahq.ai/api/v1/content/prompts"
payload := strings.NewReader("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"content_id\": \"11111111-2222-3333-4444-555555555555\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.athenahq.ai/api/v1/content/prompts")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"content_id\": \"11111111-2222-3333-4444-555555555555\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/content/prompts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"content_id\": \"11111111-2222-3333-4444-555555555555\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n }\n}"
response = http.request(request)
puts response.read_body{
"content_id": "11111111-2222-3333-4444-555555555555",
"content_url": "example.com/blog/crm-roundup",
"content_normalized_url": "example.com/blog/crm-roundup",
"prompts": [
{
"prompt_id": "22222222-3333-4444-5555-666666666666",
"prompt": "what are the best CRMs for early-stage startups?",
"citation_percent": 33.3,
"citations": 5,
"estimated_impressions": 1200
}
]
}Content Hub
Détail des citations par prompt et contenu
Pour un contenu suivi, renvoie tous les prompts dont les réponses citent l’URL, avec citations, pourcentage et impressions estimées sur la période.
Permet le détail d’une URL après POST /api/v1/content. Fonctionne pour les contenus propriétaires liés à un sujet comme pour les contenus tiers/Reddit sans sujet.
Si l’URL existe sans forme normalisée (ancienne ligne), renvoie 200 avec prompts: []. content_id inconnu : 404.
POST
/
api
/
v1
/
content
/
prompts
Détail des citations par prompt et contenu
curl --request POST \
--url https://api.athenahq.ai/api/v1/content/prompts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"content_id": "11111111-2222-3333-4444-555555555555",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
}
}
'import requests
url = "https://api.athenahq.ai/api/v1/content/prompts"
payload = {
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"content_id": "11111111-2222-3333-4444-555555555555",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
website_id: '123e4567-e89b-12d3-a456-426614174000',
content_id: '11111111-2222-3333-4444-555555555555',
filters: {start_date: '2024-01-01T00:00:00.000Z', end_date: '2024-01-31T23:59:59.999Z'}
})
};
fetch('https://api.athenahq.ai/api/v1/content/prompts', 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.athenahq.ai/api/v1/content/prompts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'website_id' => '123e4567-e89b-12d3-a456-426614174000',
'content_id' => '11111111-2222-3333-4444-555555555555',
'filters' => [
'start_date' => '2024-01-01T00:00:00.000Z',
'end_date' => '2024-01-31T23:59:59.999Z'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.athenahq.ai/api/v1/content/prompts"
payload := strings.NewReader("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"content_id\": \"11111111-2222-3333-4444-555555555555\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.athenahq.ai/api/v1/content/prompts")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"content_id\": \"11111111-2222-3333-4444-555555555555\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/content/prompts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"content_id\": \"11111111-2222-3333-4444-555555555555\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n }\n}"
response = http.request(request)
puts response.read_body{
"content_id": "11111111-2222-3333-4444-555555555555",
"content_url": "example.com/blog/crm-roundup",
"content_normalized_url": "example.com/blog/crm-roundup",
"prompts": [
{
"prompt_id": "22222222-3333-4444-5555-666666666666",
"prompt": "what are the best CRMs for early-stage startups?",
"citation_percent": 33.3,
"citations": 5,
"estimated_impressions": 1200
}
]
}Corps
application/json
Corps de requête des prompts citant un contenu donné.
Site propriétaire du contenu. Doit correspondre à son site.
Exemple:
"123e4567-e89b-12d3-a456-426614174000"
content_id renvoyé par POST /api/v1/content, résolu côté serveur en URL normalisée pour interroger les prompts dont les réponses la citent.
Exemple:
"11111111-2222-3333-4444-555555555555"
Filtres pour interroger les réponses et les indicateurs. Transmettez les filtres d’emplacements dans le corps JSON comme filters.location_ids.
Show child attributes
Show child attributes
Si true, compte uniquement les réponses qui mentionnent votre marque. Si false, uniquement celles qui ne la mentionnent pas. Omettez pour compter toutes les réponses.
Réponse
Réponse réussie avec la liste des prompts citants.
content_id interrogé.
URL d’affichage du contenu, éventuellement null pour les anciennes lignes.
URL normalisée du contenu, utilisée pour la jointure aux citations. null pour les anciennes lignes jamais normalisées ; alors prompts vaut toujours [].
Show child attributes
Show child attributes
Cette page vous a-t-elle été utile ?