Listar contenido seguido
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
}
}Centro de contenido
Listar contenido seguido
Devuelve contenido monitorizado paginado con métricas de citas, impresiones y respuestas del intervalo solicitado. Excluye el contenido oculto (is_hidden = true).
Usa consulta anticipada de page_size + 1: pagination.has_more === true indica que existe otra página; no hay campo de total.
Limita el resultado con sheet_id, content_type y los filters habituales. Un sheet_id desconocido o de otro sitio devuelve 403.
POST
/
api
/
v1
/
content
Listar contenido seguido
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
}
}Cuerpo
application/json
Cuerpo de la solicitud para listar contenido seguido.
Sitio web del que se listará el contenido seguido.
Ejemplo:
"123e4567-e89b-12d3-a456-426614174000"
Filtros para consultar respuestas y métricas. Pasa los filtros de ubicación en el cuerpo JSON como filters.location_ids.
Show child attributes
Show child attributes
Limita los resultados a un tipo de contenido. manual es contenido redactado por el usuario directamente en el editor vacío. athena_created agrupa los cuatro subtipos generados por Athena (draft, snipe, optimize, slice). Omítelo para incluir todos. Este endpoint lista contenido monitorizado y publicado, por lo que una fila en borrador —manual, draft, snipe, optimize o slice— solo aparece tras publicarse.
Opciones disponibles:
external, imported, manual, athena_created, draft, snipe, optimize, slice Limita el contenido a una pestaña del centro de contenidos. Obtén los ID con GET /api/v1/content/sheets. Una pestaña sheet lista su contenido; una view, incluida la predeterminada, lista el repositorio principal compartido (contenido sin hoja), sin los filtros guardados de la vista. Omítelo para incluir todas.
Si es true, cuenta solo las respuestas que mencionan tu marca. Si es false, cuenta solo las que no la mencionan. Omítelo para contar todas las respuestas.
Número de página, empezando en cero.
Rango requerido:
x >= 0Número de elementos por página (1–100).
Rango requerido:
1 <= x <= 100Respuesta
Respuesta correcta con la página de contenido monitorizado.
¿Esta página le ayudó?