Idlen Idlen

API de anunciantes

Gestiona campañas desde tus herramientas

Una clave de API lista campañas, crea anuncios y abre un enlace de depósito. La misma clave conecta Claude, Cursor y ChatGPT.

Ingresa 50 € y obtén 100 €

Regístrate como anunciante. El primer depósito de 50 € se iguala una vez. Cómo funciona la oferta

Qué puedes hacer

  • Listar campañas, anuncios, estadísticas diarias, el monedero y las transacciones.
  • Crear y actualizar campañas y anuncios.
  • Pausar o reanudar una campaña.
  • Crear un anuncio a partir de la URL de una página.
  • Abrir un enlace de Stripe para añadir fondos.

Antes de llamar a la API

  1. Crea la clave en Ads Manager, en Ajustes y luego Claves de API. Empieza por idl_adv_.
  2. read y write son permisos distintos. write no incluye read. Cada clave permite 120 solicitudes por minuto.
  3. Un anuncio nuevo queda pendiente hasta que una persona lo modera. Cambiar el título, el texto, el botón, el enlace o la imagen lo vuelve a dejar pendiente.
  4. La primera campaña creada por la API no se puede activar desde la API. El error es first_campaign_requires_dashboard_validation e incluye un enlace a esa campaña en el panel.
  5. Los importes van en céntimos de euro.

Inicio rápido REST

Sustituye el host por la URL de tu proyecto de Supabase. GET necesita el permiso read. POST y PATCH necesitan write.

curl 'https://<project-ref>.supabase.co/functions/v1/advertiser-api/campaigns' \
  -H 'Authorization: Bearer idl_adv_YOUR_KEY'

curl -X POST 'https://<project-ref>.supabase.co/functions/v1/advertiser-api/campaigns' \
  -H 'Authorization: Bearer idl_adv_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: campaign-2026-11-04' \
  -d '{
    "name": "Spring launch",
    "objective": "traffic",
    "budget_type": "daily",
    "budget_cents": 2000
  }'

Conectar Claude, Cursor o ChatGPT

El servidor MCP usa la misma clave, los mismos permisos y las mismas 120 solicitudes por minuto. Envía la clave como Bearer.

Claude Desktop y Claude Code

{
  "mcpServers": {
    "idlen-advertiser": {
      "type": "http",
      "url": "https://<project-ref>.supabase.co/functions/v1/advertiser-mcp",
      "headers": {
        "Authorization": "Bearer idl_adv_YOUR_KEY"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "idlen-advertiser": {
      "url": "https://<project-ref>.supabase.co/functions/v1/advertiser-mcp",
      "headers": {
        "Authorization": "Bearer idl_adv_YOUR_KEY"
      }
    }
  }
}

Pega esto en .cursor/mcp.json o en los ajustes de Cursor, luego MCP.

ChatGPT y otros clientes MCP remotos

URL
https://<project-ref>.supabase.co/functions/v1/advertiser-mcp

Header
Authorization: Bearer idl_adv_YOUR_KEY

Usa esta URL y esta cabecera. El cliente debe aceptar application/json y text/event-stream.

OpenAPI

Las rutas, los campos y los códigos de error están en el documento OpenAPI.

advertiser-api.yaml

Referencia completa en docs.idlen.io

Ingresa 50 € y obtén 100 €