Saltar al contenido principal
POST
Listar páginas de fuentes (por URL)

Autorizaciones

x-api-key
string
header
requerido

Clave de API para autenticarse. Puedes crear una aquí.

Cuerpo

application/json

Cuerpo de la solicitud para listar páginas citadas por URL.

website_id
string<uuid>
requerido

Sitio web del que se listarán las URLs citadas.

Ejemplo:

"123e4567-e89b-12d3-a456-426614174000"

filters
object
requerido

Filtros para consultar respuestas y métricas. Pasa los filtros de ubicación en el cuerpo JSON como filters.location_ids.

page_num
integer
predeterminado:0
Rango requerido: x >= 0
page_size
integer
predeterminado:30
Rango requerido: 1 <= x <= 100
sort_field
enum<string>
predeterminado:citation_percentage
Opciones disponibles:
citation_percentage,
estimated_impressions,
total_mentions,
mentions_count,
normalized_url,
competitor_ids,
first_seen
sort_direction
enum<string>
predeterminado:desc
Opciones disponibles:
asc,
desc
search
string | null

Filtro de subcadena sobre normalized_url Y normalized_root_domain. Se eliminan protocolo (https://), www., consulta y fragmento antes de comparar; se conserva la ruta para permitir búsquedas de URL concretas.

mentioned
enum<string>

Si es yes, cuenta solo las fuentes cuya respuesta citante menciona tu marca. Si es no, solo aquellas cuya respuesta NO la menciona. Omite el campo para contar todas las fuentes citadas.

Opciones disponibles:
yes,
no
competitors_mentioned
enum<string>

Si es yes, cuenta solo las fuentes cuya respuesta citante menciona tu marca. Si es no, solo aquellas cuya respuesta NO la menciona. Omite el campo para contar todas las fuentes citadas.

Opciones disponibles:
yes,
no

Respuesta

Respuesta correcta con la página de URL citadas.

pages
object[]
requerido
pagination
object
requerido

Metadatos de paginación. A diferencia de Pagination (que usa consulta anticipada con has_more), las fuentes muestran un total exacto: la consulta de ClickHouse lo calcula con una función de ventana en el mismo recorrido, sin otra llamada adicional.