Répertorier le contenu suivi
curl --request POST \
--url https://api.athenahq.ai/api/v1/content \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
},
"sheet_id": "00000000-0000-4000-8000-000000000001",
"page_size": 50
}
'import requests
url = "https://api.athenahq.ai/api/v1/content"
payload = {
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
},
"sheet_id": "00000000-0000-4000-8000-000000000001",
"page_size": 50
}
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',
filters: {start_date: '2024-01-01T00:00:00.000Z', end_date: '2024-01-31T23:59:59.999Z'},
sheet_id: '00000000-0000-4000-8000-000000000001',
page_size: 50
})
};
fetch('https://api.athenahq.ai/api/v1/content', 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",
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',
'filters' => [
'start_date' => '2024-01-01T00:00:00.000Z',
'end_date' => '2024-01-31T23:59:59.999Z'
],
'sheet_id' => '00000000-0000-4000-8000-000000000001',
'page_size' => 50
]),
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"
payload := strings.NewReader("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n },\n \"sheet_id\": \"00000000-0000-4000-8000-000000000001\",\n \"page_size\": 50\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")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n },\n \"sheet_id\": \"00000000-0000-4000-8000-000000000001\",\n \"page_size\": 50\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/content")
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 \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n },\n \"sheet_id\": \"00000000-0000-4000-8000-000000000001\",\n \"page_size\": 50\n}"
response = http.request(request)
puts response.read_body{
"content": [
{
"content_id": "11111111-2222-3333-4444-555555555555",
"title": "Best CRMs for Startups, Reviewed",
"url": "example.com/blog/crm-roundup",
"normalized_url": "example.com/blog/crm-roundup",
"type": "external",
"topic_name": "CRM Software",
"sheet_id": "00000000-0000-4000-8000-000000000001",
"sheet_name": "3rd-Party Placements",
"citations": 42,
"citation_percent": 12.5,
"estimated_impressions": 18400,
"total_responses": 336,
"mark_as_done_time": "2024-01-15T00:00:00.000Z",
"created_at": "2024-01-10T00:00:00.000Z"
}
],
"pagination": {
"page_num": 0,
"page_size": 50,
"has_more": true
}
}Content Hub
Répertorier le contenu suivi
Renvoie le contenu suivi paginé avec les indicateurs de citation, d’impression et de réponse joints pour la période demandée. Le contenu masqué (is_hidden = true) est exclu.
La pagination utilise une anticipation page_size + 1 — pagination.has_more === true signifie que la page suivante existe ; aucun champ de nombre total n’est fourni.
Utilisez sheet_id, content_type et les filters standard pour limiter les résultats. Un sheet_id inconnu (ou d’un autre site web) fait renvoyer 403 à l’endpoint.
POST
/
api
/
v1
/
content
Répertorier le contenu suivi
curl --request POST \
--url https://api.athenahq.ai/api/v1/content \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
},
"sheet_id": "00000000-0000-4000-8000-000000000001",
"page_size": 50
}
'import requests
url = "https://api.athenahq.ai/api/v1/content"
payload = {
"website_id": "123e4567-e89b-12d3-a456-426614174000",
"filters": {
"start_date": "2024-01-01T00:00:00.000Z",
"end_date": "2024-01-31T23:59:59.999Z"
},
"sheet_id": "00000000-0000-4000-8000-000000000001",
"page_size": 50
}
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',
filters: {start_date: '2024-01-01T00:00:00.000Z', end_date: '2024-01-31T23:59:59.999Z'},
sheet_id: '00000000-0000-4000-8000-000000000001',
page_size: 50
})
};
fetch('https://api.athenahq.ai/api/v1/content', 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",
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',
'filters' => [
'start_date' => '2024-01-01T00:00:00.000Z',
'end_date' => '2024-01-31T23:59:59.999Z'
],
'sheet_id' => '00000000-0000-4000-8000-000000000001',
'page_size' => 50
]),
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"
payload := strings.NewReader("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n },\n \"sheet_id\": \"00000000-0000-4000-8000-000000000001\",\n \"page_size\": 50\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")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"website_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n },\n \"sheet_id\": \"00000000-0000-4000-8000-000000000001\",\n \"page_size\": 50\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/content")
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 \"filters\": {\n \"start_date\": \"2024-01-01T00:00:00.000Z\",\n \"end_date\": \"2024-01-31T23:59:59.999Z\"\n },\n \"sheet_id\": \"00000000-0000-4000-8000-000000000001\",\n \"page_size\": 50\n}"
response = http.request(request)
puts response.read_body{
"content": [
{
"content_id": "11111111-2222-3333-4444-555555555555",
"title": "Best CRMs for Startups, Reviewed",
"url": "example.com/blog/crm-roundup",
"normalized_url": "example.com/blog/crm-roundup",
"type": "external",
"topic_name": "CRM Software",
"sheet_id": "00000000-0000-4000-8000-000000000001",
"sheet_name": "3rd-Party Placements",
"citations": 42,
"citation_percent": 12.5,
"estimated_impressions": 18400,
"total_responses": 336,
"mark_as_done_time": "2024-01-15T00:00:00.000Z",
"created_at": "2024-01-10T00:00:00.000Z"
}
],
"pagination": {
"page_num": 0,
"page_size": 50,
"has_more": true
}
}Corps
application/json
Corps de requête de liste des contenus suivis.
Site dont lister le contenu suivi.
Exemple:
"123e4567-e89b-12d3-a456-426614174000"
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
Limite au type de contenu. manual : rédaction utilisateur dans l’éditeur vierge. athena_created regroupe draft, snipe, optimize, slice. Omettez pour tous. Ce point liste les contenus suivis/publiés : un brouillon manual, draft, snipe, optimize ou slice n’apparaît qu’après publication.
Options disponibles:
external, imported, manual, athena_created, draft, snipe, optimize, slice Limite à un onglet Content Hub. Découvrez les ID via GET /api/v1/content/sheets. Une sheet liste son propre contenu ; une view, onglet par défaut inclus, liste l’inventaire principal partagé sans les filtres enregistrés, soit le contenu hors feuilles. Omettez pour tous les onglets.
Si true, compte seulement les réponses mentionnant votre marque ; si false, celles qui ne la mentionnent pas. Omettez pour toutes.
Numéro de page commençant à zéro.
Plage requise:
x >= 0Nombre d’éléments par page (1 à 100).
Plage requise:
1 <= x <= 100Réponse
Réponse réussie avec la page de contenus suivis.
Cette page vous a-t-elle été utile ?