Fuentes e inteligencia de citaciones

Todas las URL que citaron los modelos, además de vistas agrupadas por URL, dominio y host, metadatos de caché de página, evidencia de menciones dentro de las páginas citadas, listas de apariciones y contenido en caché saneado.

Las URL citadas conservan sus métricas de citaciones cuando el contenido de la página no está disponible. Si se desconocen las menciones de una página, ahora se devuelve null; content_gap_status incluye content_unavailable. Los resultados de rastreo vacíos ya no aparecen como páginas analizadas. Los estados 404 y 410 observados siguen visibles.

GET`/dimensions/sources`

Enumera las fuentes no rechazadas generadas por las ejecuciones de prompt.

Parámetros:

project_idobligatorio
model
collection_id
promptID de prompt
country_code
language_code
from
to
page
per_page
source_typeowned|competitor|third_party
mention_filter
competitors

Cualquier otro valor de source_type, aunque solo difiera en mayúsculas y minúsculas, devuelve ERR_INVALID_PARAM. Aquí, mention_filter se aplica a las marcas que aparecen en el contenido rastreado de cada página citada, no en la respuesta de IA, igual que en la página de Citaciones.

GET`/citation_intelligence/groups`

Inteligencia de citaciones agrupada por url, domain o host con desglose por modelo, tasa de citaciones y posición media de la citación (ignora las filas con position = 0).

Parámetros:

project_idobligatorio
viewurl|domain|host
page
per_page
ordergroup_key, total_responses, total_citations, citation_rate, avg_citation_position, first_seen_at, last_seen_at
direction
model
collection_id
country_code
language_code
prompt
from
to
query
source_typeowned|competitor|third_party|social_media|own_domain|ugc|background
sentimentnegative
content_gapmentioned|gap

Los valores de enumeración no válidos devuelven ERR_INVALID_PARAM.

GET`/citation_intelligence/mentions_by_domain`

Para las respuestas en las que se cita cada dominio de origen indicado, la cuota de esas respuestas que mencionan tu marca frente a cada competidor. La marca y los competidores se normalizan para que sumen 100 % por dominio, siguiendo la definición de mención del Share of Voice. Pasa varios dominios para analizar la matriz completa en una sola llamada.

Parámetros:

project_idobligatorio
domainsarray obligatorio, p. ej. domains[]=example.com, máximo 50
model
collection_id
collection_ids
country_code
language_code
prompt
brand_kindbrand|brand_other|non_brand
from
to

Un domains vacío devuelve ERR_INVALID_PARAM. Cada fila contiene responses_citing, total_mentions y un array actors (la marca y los competidores, con mentions y share).

GET`/citation_intelligence/urls/:url_sha256`

Detalle a nivel de URL de una página citada: totales, tasa de citaciones, posición media de la citación, recuentos por tipo de fuente, recuentos por modelo, variantes de URL distintas, metadatos de la caché de página y evidencia de menciones en la página con fragmentos y etiquetas de actor.

Parámetros: project_id (obligatorio), :url_sha256 (64 caracteres hexadecimales en la URL), los mismos filtros opcionales que /citation_intelligence/groups. ERR_NOT_FOUND solo cuando el proyecto nunca ha citado la URL; los filtros que vacían el resultado siguen devolviendo 200 con estadísticas a cero.

GET`/citation_intelligence/urls/:url_sha256/occurrences`

Ocurrencias paginadas de una URL citada en las ejecuciones de prompt, con extracto de la respuesta, texto del prompt, modelo, executed_at, citation_position y source_type por fila.

Parámetros: project_id (obligatorio), :url_sha256 (64 caracteres hexadecimales), page, per_page y los mismos filtros opcionales que /citation_intelligence/groups.

GET`/citation_intelligence/urls/:url_sha256/content`

Contenido saneado de la página en caché para una URL citada: metadatos de la caché de página, evidencia de menciones y fragmentos, texto plano completo y HTML renderizado (se eliminan los scripts y el marcado no seguro).

Parámetros:

project_idobligatorio
:url_sha25664 caracteres hexadecimales

Ejemplos de código

Download: OpenAPI Swagger Postman

Preguntar a la IA: Abrir en ChatGPT Abrir en Claude Ver como Markdown

Idioma

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/sources?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/sources?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/sources?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/sources?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/sources?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/dimensions/sources?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/dimensions/sources?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{ "project_id":4, "page":1, "per_page":20, "total":57,
  "data":[ { "id":501, "prompt_execution_id":9001, "domain":"example.com", "url":"https://example.com/x", "position":1 } ],
  "request_id":"..." }

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/citation_intelligence/groups?project_id=PROJECT_ID&view=domain&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/citation_intelligence/groups?project_id=PROJECT_ID&view=domain&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/citation_intelligence/groups?project_id=PROJECT_ID&view=domain&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/citation_intelligence/groups?project_id=PROJECT_ID&view=domain&range=30",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/citation_intelligence/groups?project_id=PROJECT_ID&view=domain&range=30", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/citation_intelligence/groups?project_id=PROJECT_ID&view=domain&range=30', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/citation_intelligence/groups?project_id=PROJECT_ID&view=domain&range=30"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/citation_intelligence/mentions_by_domain?project_id=PROJECT_ID&domains=nytimes.com&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/citation_intelligence/mentions_by_domain?project_id=PROJECT_ID&domains=nytimes.com&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/citation_intelligence/mentions_by_domain?project_id=PROJECT_ID&domains=nytimes.com&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/citation_intelligence/mentions_by_domain?project_id=PROJECT_ID&domains=nytimes.com&range=30",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/citation_intelligence/mentions_by_domain?project_id=PROJECT_ID&domains=nytimes.com&range=30", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/citation_intelligence/mentions_by_domain?project_id=PROJECT_ID&domains=nytimes.com&range=30', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/citation_intelligence/mentions_by_domain?project_id=PROJECT_ID&domains=nytimes.com&range=30"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/occurrences?project_id=PROJECT_ID&per_page=50"

const response = await fetch("https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/occurrences?project_id=PROJECT_ID&per_page=50", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/occurrences?project_id=PROJECT_ID&per_page=50",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/occurrences?project_id=PROJECT_ID&per_page=50",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/occurrences?project_id=PROJECT_ID&per_page=50", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/occurrences?project_id=PROJECT_ID&per_page=50', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/occurrences?project_id=PROJECT_ID&per_page=50"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/content?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/content?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/content?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/content?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/content?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/content?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/citation_intelligence/urls/URL_SHA256/content?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Fuentes e inteligencia de citaciones

GET/dimensions/sources

GET/citation_intelligence/groups

GET/citation_intelligence/mentions_by_domain

GET/citation_intelligence/urls/:url_sha256

GET/citation_intelligence/urls/:url_sha256/occurrences

GET/citation_intelligence/urls/:url_sha256/content

GET`/dimensions/sources`

GET`/citation_intelligence/groups`

GET`/citation_intelligence/mentions_by_domain`

GET`/citation_intelligence/urls/:url_sha256`

GET`/citation_intelligence/urls/:url_sha256/occurrences`

GET`/citation_intelligence/urls/:url_sha256/content`