Saltar al contenido principal
POST
Listar fuentes (por dominio raíz)

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 fuentes agrupadas por dominio.

website_id
string<uuid>
requerido

Sitio web del que se listarán las fuentes.

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

Número de página, empezando en cero.

Rango requerido: x >= 0
page_size
integer
predeterminado:30

Número de filas por página (1–100).

Rango requerido: 1 <= x <= 100
sort_field
enum<string>
predeterminado:citation_percentage

Columna por la que se ordenará.

Opciones disponibles:
citation_percentage,
mention_percentage,
competitor_mention_percentage,
brand_mention_percentage,
estimated_impressions,
total_mentions,
domain_count,
mentions_count,
root_domain,
response_count,
first_seen
sort_direction
enum<string>
predeterminado:desc
Opciones disponibles:
asc,
desc
search
string | null

Filtro de subcadena sobre normalized_root_domain. Se eliminan protocolo (https://), www., ruta, consulta y fragmento antes de comparar, por lo que una URL como https://www.example.com/foo queda en example.com.

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 fuentes.

sources
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.