La REST API de ClickFlare,para lanzamientos en bloque y automatización

La REST API de ClickFlare permite que tu propio código haga lo que repites en la interfaz: lanzar campañas, ofertas y landers en bloque, mantener ClickFlare sincronizado con tus sistemas y llevar los datos de reportes a cualquier sitio. Cubre 54 endpoints, y cada petición usa tu API key.

API
REST API
API pública de ClickFlare

REST API: la integración de un vistazo

Cómo se conecta
Peticiones seguras a la API autenticadas con tu API key
Qué se sincroniza
Campañas, ofertas, landers, flujos, reportes y registros
Frescura de los datos
Bajo demanda, por petición
Qué puedes optimizar
Datos de reportes por cualquier desglose, en tus propias herramientas
Funciona con
Cualquier lenguaje o herramienta que pueda enviar peticiones HTTPS
Conviene saber
Una clave tiene el acceso de tu cuenta. Mantenla en tu servidor.
API pública
54 endpoints
Lanzamientos en bloque

Automatiza con scripts el trabajo que repites en la interfaz

Lanza en bloque

Crea, clona, archiva y desarchiva campañas, ofertas y landers desde código cuando lanzas decenas a la vez.

Sincroniza con tus sistemas

Mantén ClickFlare sincronizado con tus herramientas internas gestionando fuentes de tráfico, redes de afiliados, dominios e integraciones por la API.

Reportes en cualquier sitio

Lleva los datos de reportes a una herramienta de BI, un almacén de datos o tus propios scripts, agrupados como necesites.
Cómo funciona

Del clic en el anuncio a beneficio por campañaingresos atribuidosventas atribuidasuna conversión emparejadauna acción automatizadatus dashboardsingresos cerrados

01
Tu anuncio
El visitante hace clic
Anuncio en REST API
02
ClickFlare
Clic registrado
Cada clic recibe su propio ID
03
Tu oferta
Conversión
Lead, venta o evento personalizado
04
ClickFlare
Enviada a REST API
Por la Conversion API o por postback
05
API de costos
Gasto importado
REST API: costo asignado a cada campaña
01
Tu anuncio
REST API: clic
Con ubicación, dispositivo y país
02
ClickFlare
Clic registrado
Se guardan zona, sitio y dispositivo
03
Oferta o lander
El visitante convierte
En tu página o en la oferta
04
ClickFlare
Conversión registrada
Con payout y tipo de evento
05
Postback
Reportada a REST API
Para que su optimización vea el resultado
01
Tu anuncio
El visitante hace clic
Cualquier fuente de tráfico
02
ClickFlare
Clic registrado
Cada clic recibe su propio ID
03
Tu artículo
Bloque de palabras clave
Click ID enviado al feed
04
Página de resultados
Clic pagado
Conversión enviada a ClickFlare
05
REST API API
Ingresos emparejados
Importados según calendario y conciliados
01
Tu anuncio
El visitante hace clic
Cualquier fuente de tráfico
02
ClickFlare
Clic registrado
El clic acompaña al visitante hasta la oferta
03
REST API
Oferta o llamada
La red registra la acción
04
REST API
Conversión
Lead, venta, llamada o rebill
05
Postback
Payout en ClickFlare
Emparejado con el clic original
01
Tu anuncio
El visitante hace clic
Cualquier fuente de tráfico
02
ClickFlare
Clic registrado
Cada clic recibe su propio ID
03
REST API
Tienda o embudo
Click ID conservado hasta el checkout
04
Eventos
Vista, carrito, checkout
Cada paso registrado
05
ClickFlare
Compra registrada
Valor del pedido emparejado con el anuncio
01
Tu anuncio
El visitante hace clic
Formulario, llamada o landing
02
ClickFlare
Clic registrado
Cada clic recibe su propio ID
03
REST API
Lead o llamada guardados
El anuncio queda vinculado al lead
04
REST API
Calificado o cerrado
Se activa el workflow o la regla de llamada
05
ClickFlare
Ingresos registrados
Vinculados al anuncio que los generó
01
ClickFlare
Ocurre un evento
Clic, conversión o evento personalizado
02
Webhook o API
Los datos salen
O vuelven a entrar
03
REST API
Tu workflow
Reglas, apps o un asistente de IA
04
REST API
Acción
Alertar, actualizar, pausar o escalar
05
ClickFlare
De vuelta en los reportes
Los cambios aparecen en tus datos
01
ClickFlare
Datos de reportes
Campañas, fuentes, ofertas
02
API de ClickFlare
Tus números salen
Protegidos con tu API key
03
Tu configuración
Actualización programada
Una hoja, un script o un conector
04
REST API
Llegan los datos
Tablas actualizadas según calendario
05
REST API
Dashboards
Combinados con tus otros datos
API pública

Cómo está organizada la API de ClickFlare

La API refleja los objetos de la interfaz con los mismos campos obligatorios, así que una oferta válida en ClickFlare es una oferta válida en la API. Cada petición lleva tu API key.
  • Mismos objetos y campos que la interfaz
  • Referencia completa en el portal para desarrolladores
  • Las peticiones sin una clave válida se rechazan
Hoy, una campaña
ejemplo
Gasto importado de REST API
costo
$412.30
Conversiones registradas
hoy
38
Enviada a REST API
por evento
38/38
Beneficio
campaña
$227.70
Cifras de ejemplo. El costo y las conversiones aparecen en la misma fila del reporte.
ROI por ubicación
ejemplo
Ubicación A · móvil
costo
$38.20
Ubicación A
ingresos
$71.40
Ubicación A
ROI
+87%
Ubicación B · escritorio
ROI
−42%
Cifras de ejemplo. Mantén las ubicaciones que rinden y corta las que pierden dinero.
Ingresos de un clic
ejemplo
Clic pagado
día 0
$0.00
Primera importación de ingresos
+1h
$0.41
Actualizaciones programadas
días siguientes
$0.58
Importación final
última sinc.
$0.62
Importes de ejemplo. El ritmo de sincronización de REST API está en los datos de arriba.
Eventos de un clic
ejemplo
Lead
día 0
$0.00
Venta
día 0
+$40.00
Upsell
día 1
+$15.00
Reembolso
día 9
−$15.00
Eventos de ejemplo. Cada uno llega por postback y se empareja con el clic.
El recorrido de un visitante
ejemplo
Vista de producto
paso 1
—
Añadir al carrito
paso 2
—
Checkout
paso 3
—
Compra
paso 4
$68.00
Pedido de ejemplo. Cada evento queda vinculado al anuncio que trajo al visitante.
Un lead, seguido hasta los ingresos
ejemplo
Lead creado
día 0
$0.00
Calificado
día 2
+$25.00
Venta cerrada
día 14
+$480.00
Renovación
día 45
+$120.00
Valores de ejemplo. Cada etapa puede ser su propio tipo de evento en ClickFlare.
Una actualización programada del reporte
ejemplo
Campañas
en el reporte
1.240 filas
Costo, ingresos, beneficio
por campaña
incluido
Actualización
tu calendario
hecho
Dashboards alimentados
REST API
3
Cifras de ejemplo. Tú eliges los desgloses, el rango de fechas y el calendario.
Un evento, de principio a fin
ejemplo
Conversión registrada
evento
enviado
Evento entregado
REST API
recibido
Workflow ejecutado
REST API
hecho
Equipo avisado
tus apps
hecho
Ejecución de ejemplo. Lo que pasa después del evento depende de tu workflow.
54
Endpoints de la API
2.300 M
Eventos registrados
Configuración

Conectado en tres pasos

Necesitas una cuenta de ClickFlare, una API key y un script o herramienta que pueda enviar peticiones HTTPS.
  1. Genera una API key Crea una clave en ClickFlare. Mantenla fuera del código del lado del cliente, de las landing pages y de todo lo que compartas.
  2. Envíala con cada petición Tu clave va con cada petición. No hay un inicio de sesión aparte, y las peticiones sin ella se rechazan.
  3. Parte de un ejemplo que funcione Crea primero una campaña a mano y descárgala por la API para ver cómo es un objeto válido antes de automatizar más.
app.clickflare.com/integrations
API
REST API
API pública
Conectado
REST API: cuenta conectada
Sesión iniciada desde ClickFlare
Costos sincronizándose
Gasto asignado a las campañas
Conversiones devueltas
Los eventos que elijas
REST API: plantilla seleccionada
Macros ya rellenadas
URL de seguimiento en REST API
Click ID capturado
Conversiones reportadas
Payout incluido cuando se admite
REST API: conectado
Credenciales guardadas en ClickFlare
Evento de conversión configurado
Click ID enviado al feed
Ingresos sincronizándose
Según el calendario del feed
REST API: añadida
La URL de la oferta lleva el click ID
Postback configurado en REST API
Payout y evento incluidos
Conversiones llegando
Emparejadas con el clic
REST API: conectado
Click ID conservado hasta el checkout
Eventos mapeados
Vista, carrito, checkout, compra
Compras registradas
Valor del pedido en los reportes
Click ID guardado en REST API
Campo oculto o datos de la llamada
Workflow o regla configurados
Se activa en la etapa que elijas
Conversiones llegando
Con payout y tipo de evento
API key creada
Ajustes, luego Seguridad
Importación de reportes programada
Dimensiones y rango de fechas definidos
REST API: dashboards activos
Actualizados según calendario
Conexión configurada
Webhook, API key o MCP
Eventos elegidos
Solo lo que necesita el workflow
Workflow en marcha
Probado de principio a fin
Listo para trackear
La API crea objetos pero no comprueba el tracking. Las campañas creadas con ella siguen necesitando que el click ID llegue a la oferta y un postback en la red.
Resumen de la API de ClickFlare
Abrir la guía
En tus reportes

Lo que ves una vez conectado

  • Datos de reportes por cualquier desglose
  • Registros de eventos y de actividad del sistema
  • Listas de campañas, ofertas y landers
  • Cargas manuales de costos
  • Cargas de conversiones en bruto
Casos de uso

Cómo lo usan los media buyers

Lanzamientos de campañas en bloque

Clona una campaña probada para cada nuevo país u oferta desde un script, reutilizando las ofertas y fuentes de tráfico existentes en lugar de duplicarlas.

Costos desde tu propia fuente

Sube costos manuales a las campañas por la API cuando el gasto viene de una fuente que ClickFlare no importa por ti.

Reportes en tu stack

Descarga datos de reportes de forma programada a una herramienta de BI o un almacén de datos, agrupados por campaña, oferta o fuente de tráfico.
Preguntas frecuentes

REST API: preguntas frecuentes

¿ClickFlare se integra con otras herramientas mediante una API?

Sí. La REST API pública de ClickFlare tiene 54 endpoints para campañas, ofertas, landers, flujos, fuentes de tráfico, redes de afiliados, dominios, integraciones y reportes.

¿Cómo autentico las peticiones a la API?

Genera una API key en ClickFlare y envíala con cada petición. No hay un inicio de sesión aparte, y las peticiones sin una clave válida se rechazan.

¿Dónde está la referencia completa de endpoints?

En el portal para desarrolladores de ClickFlare, que también ofrece la descripción completa de la API si quieres generar un cliente.

¿Puedo descargar reportes por la API?

Sí. Puedes descargar datos de reportes agrupados como necesites, así que puedes alimentar herramientas de BI, almacenes de datos o tus propios scripts.

¿La API comprueba que mi tracking funciona?

No. Solo crea objetos. Las campañas siguen necesitando que el click ID llegue a la oferta y un postback configurado en la red.

¿Debo crear una oferta nueva para cada campaña?

No. Las ofertas, los landers, las fuentes de tráfico y las redes de afiliados se comparten entre campañas. Reutiliza la que ya existe, o tus reportes se fragmentarán.

Guías de configuración
Resumen de la API de ClickFlare