Saltar al contenido principal
POST
Desglose de citas por consulta y contenido

Autorizaciones

x-api-key
string
header
requerido

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

Cuerpo

application/json

Cuerpo de la solicitud para consultar en detalle las consultas que citan un único elemento de contenido.

website_id
string<uuid>
requerido

Sitio web al que pertenece el elemento de contenido. Debe coincidir con el del contenido.

Ejemplo:

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

content_id
string<uuid>
requerido

El content_id devuelto por POST /api/v1/content. El endpoint lo resuelve en el servidor a una URL normalizada y consulta todas las consultas cuyas respuestas la citan.

Ejemplo:

"11111111-2222-3333-4444-555555555555"

filters
object
requerido

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

mentioned
boolean

Si es true, cuenta solo las respuestas que mencionan tu marca. Si es false, solo las que no la mencionan. Omítelo para contar todas las respuestas.

Respuesta

Respuesta correcta con la lista de consultas que citan el contenido.

content_id
string<uuid>
requerido

El content_id que se ha consultado.

content_url
string | null
requerido

URL visible del contenido (puede ser null en filas antiguas).

content_normalized_url
string | null
requerido

URL normalizada del contenido: el valor que se cruza con los datos de citas. null para filas antiguas que nunca se han normalizado; en ese caso prompts siempre es [].

prompts
object[]
requerido