Répertorier les pages sources (par URL)
curl --request POST \
--url https://api.athenahq.ai/api/v1/source-pages \
--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"
},
"page_size": 30
}
'import requests
url = "https://api.athenahq.ai/api/v1/source-pages"
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"
},
"page_size": 30
}
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'},
page_size: 30
})
};
fetch('https://api.athenahq.ai/api/v1/source-pages', 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/source-pages",
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'
],
'page_size' => 30
]),
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/source-pages"
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 \"page_size\": 30\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/source-pages")
.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 \"page_size\": 30\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/source-pages")
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 \"page_size\": 30\n}"
response = http.request(request)
puts response.read_body{
"pages": [
{
"normalized_url": "wikipedia.org/wiki/Customer_Relationship_Management",
"domain": "en.wikipedia.org",
"root_domain": "wikipedia.org",
"normalized_root_domain": "wikipedia.org",
"total_mentions": 24,
"estimated_impressions": 3400,
"citation_percentage": 2.7,
"mentions_count": 9,
"competitor_ids": [],
"default_source_type": "third_party",
"source_type_ids": [],
"first_seen": "2024-01-07",
"daily_mentions": [
{
"date": "2024-01-07",
"citation_percentage": 0.4
},
{
"date": "2024-01-08",
"citation_percentage": 0.6
}
]
}
],
"pagination": {
"page_num": 0,
"page_size": 30,
"total": 412
}
}Sources
Répertorier les pages sources (par URL)
Renvoie les URL citées du site avec citations, mentions et impressions, une ligne par normalized_url. Chaque ligne inclut une mini-courbe daily_mentions du pourcentage quotidien de citations et la classification de POST /api/v1/sources.
Utilisez-le pour le détail par URL, par exemple les articles d’un partenaire à l’origine des citations. Pour l’agrégat par domaine, utilisez POST /api/v1/sources. Propriété et étiquettes correspondent aux URL originales en conservant hôtes, casse des chemins et contraintes de requête. Les résultats gardent leurs identifiants normalisés et pagination, combinant les étiquettes des variantes correspondantes par ligne de page.
POST
/
api
/
v1
/
source-pages
Répertorier les pages sources (par URL)
curl --request POST \
--url https://api.athenahq.ai/api/v1/source-pages \
--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"
},
"page_size": 30
}
'import requests
url = "https://api.athenahq.ai/api/v1/source-pages"
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"
},
"page_size": 30
}
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'},
page_size: 30
})
};
fetch('https://api.athenahq.ai/api/v1/source-pages', 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/source-pages",
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'
],
'page_size' => 30
]),
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/source-pages"
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 \"page_size\": 30\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/source-pages")
.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 \"page_size\": 30\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/source-pages")
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 \"page_size\": 30\n}"
response = http.request(request)
puts response.read_body{
"pages": [
{
"normalized_url": "wikipedia.org/wiki/Customer_Relationship_Management",
"domain": "en.wikipedia.org",
"root_domain": "wikipedia.org",
"normalized_root_domain": "wikipedia.org",
"total_mentions": 24,
"estimated_impressions": 3400,
"citation_percentage": 2.7,
"mentions_count": 9,
"competitor_ids": [],
"default_source_type": "third_party",
"source_type_ids": [],
"first_seen": "2024-01-07",
"daily_mentions": [
{
"date": "2024-01-07",
"citation_percentage": 0.4
},
{
"date": "2024-01-08",
"citation_percentage": 0.6
}
]
}
],
"pagination": {
"page_num": 0,
"page_size": 30,
"total": 412
}
}Corps
application/json
Corps de liste des pages citées par URL.
Site dont lister les URL citées.
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
Plage requise:
x >= 0Plage requise:
1 <= x <= 100Options disponibles:
citation_percentage, estimated_impressions, total_mentions, mentions_count, normalized_url, competitor_ids, first_seen Options disponibles:
asc, desc Filtre de sous-chaîne sur normalized_url ET normalized_root_domain. Protocole (https://), www., requête et fragment sont retirés avant comparaison ; le chemin est conservé pour les recherches d’URL précises.
Avec yes, compte uniquement les sources dont la réponse citante mentionne votre marque. Avec no, uniquement celles dont la réponse ne la mentionne PAS. Omettez le champ pour compter toutes les sources citées.
Options disponibles:
yes, no Avec yes, compte uniquement les sources dont la réponse citante mentionne votre marque. Avec no, uniquement celles dont la réponse ne la mentionne PAS. Omettez le champ pour compter toutes les sources citées.
Options disponibles:
yes, no Réponse
Réponse réussie avec la page d’URL citées.
Show child attributes
Show child attributes
Métadonnées de pagination. Contrairement à Pagination (qui utilise une anticipation has_more), les vues de sources exposent un nombre total précis — la requête ClickHouse sous-jacente le calcule comme fonction de fenêtre dans le même parcours, sans coût d’aller-retour supplémentaire.
Show child attributes
Show child attributes
Cette page vous a-t-elle été utile ?