Obtener Adsets de una Campaña

curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1/120200000000001?datePreset=last_7d&start=2026-04-25T00:00:00Z&end=2026-05-02T00:00:00Z" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "23856000000001",
      "name": "Adset Principal",
      "insights": {
        "data": [
          {
            "account_currency": "MXN",
            "spend": "1250.50"
          }
        ]
      },
      "ads": {
        "data": [
          {
            "id": "23856000000002",
            "name": "Anuncio Imagen",
            "source_ad_id": "23856000000000",
            "mensajes_iniciados": 15,
            "ventas": 3,
            "cotizaciones": 7,
            "insights": { "data": [] },
            "adcreatives": {}
          }
        ]
      },
      "campaign": {
        "id": "120200000000001",
        "name": "Campaña Verano 2026",
        "status": "ACTIVE",
        "lifetime_budget": "5000000",
        "budget_remaining": "2000000"
      }
    }
  ]
}

{
  "message": "Missing token"
}

GET

empresas

campaigns

{businessId}

{campaignId}

curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1/120200000000001?datePreset=last_7d&start=2026-04-25T00:00:00Z&end=2026-05-02T00:00:00Z" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "23856000000001",
      "name": "Adset Principal",
      "insights": {
        "data": [
          {
            "account_currency": "MXN",
            "spend": "1250.50"
          }
        ]
      },
      "ads": {
        "data": [
          {
            "id": "23856000000002",
            "name": "Anuncio Imagen",
            "source_ad_id": "23856000000000",
            "mensajes_iniciados": 15,
            "ventas": 3,
            "cotizaciones": 7,
            "insights": { "data": [] },
            "adcreatives": {}
          }
        ]
      },
      "campaign": {
        "id": "120200000000001",
        "name": "Campaña Verano 2026",
        "status": "ACTIVE",
        "lifetime_budget": "5000000",
        "budget_remaining": "2000000"
      }
    }
  ]
}

{
  "message": "Missing token"
}

Retorna los adsets (conjuntos de anuncios) de una campaña de Meta Ads, incluyendo los anuncios individuales con sus métricas de mensajes iniciados, ventas y cotizaciones.

Autenticación

Requiere el encabezado x-api-key con el App Key del negocio. Consulta Autenticación.

Parámetros de ruta

number

required

ID del negocio al que pertenece la campaña.

string

required

ID de la campaña de Meta Ads cuyos adsets se desean obtener.

Parámetros de consulta

string

Período predefinido para las métricas de Meta. Valores aceptados: today, yesterday, last_7d, last_30d, this_month, maximum. Por defecto today.

string

ID de la cuenta publicitaria de Meta. Si se omite, se usa la cuenta predeterminada del negocio.

string

Fecha de inicio en formato ISO 8601. Usada para filtrar métricas de mensajes, ventas y cotizaciones.

string

Fecha de fin en formato ISO 8601. Usada para filtrar métricas de mensajes, ventas y cotizaciones.

Respuesta

array

Lista de adsets con sus anuncios.

Show Objeto MetaAdsetWithAds

string

ID del adset en Meta.

string

Nombre del adset.

object

Métricas de gasto del adset.

Show insights.data[]

string

Moneda de la cuenta (ej. MXN, USD).

string

Gasto total del adset en el período.

object

Anuncios dentro del adset.

Show ads.data[] (MetaAdsetAd)

string

ID del anuncio.

string

Nombre del anuncio.

string

ID del anuncio fuente.

number

Conversaciones iniciadas desde el anuncio.

number

Ventas atribuidas al anuncio.

number

Cotizaciones atribuidas al anuncio.

object

Métricas de rendimiento del anuncio.

object

Creativos del anuncio.

object

Campaña padre del adset (objeto MetaCampaign).

curl -X GET "https://beta.api-iobot-desarrollo.com/empresas/campaigns/1/120200000000001?datePreset=last_7d&start=2026-04-25T00:00:00Z&end=2026-05-02T00:00:00Z" \
  -H "x-api-key: TU_APP_KEY"

{
  "data": [
    {
      "id": "23856000000001",
      "name": "Adset Principal",
      "insights": {
        "data": [
          {
            "account_currency": "MXN",
            "spend": "1250.50"
          }
        ]
      },
      "ads": {
        "data": [
          {
            "id": "23856000000002",
            "name": "Anuncio Imagen",
            "source_ad_id": "23856000000000",
            "mensajes_iniciados": 15,
            "ventas": 3,
            "cotizaciones": 7,
            "insights": { "data": [] },
            "adcreatives": {}
          }
        ]
      },
      "campaign": {
        "id": "120200000000001",
        "name": "Campaña Verano 2026",
        "status": "ACTIVE",
        "lifetime_budget": "5000000",
        "budget_remaining": "2000000"
      }
    }
  ]
}

{
  "message": "Missing token"
}

Plantillas de Mensajes

Chats

Campañas

Reporte Compartido

Campañas Meta

Ordenes

Autenticación

Parámetros de ruta

Parámetros de consulta

Respuesta

​Autenticación

​Parámetros de ruta

​Parámetros de consulta

​Respuesta

Autenticación

Parámetros de ruta

Parámetros de consulta

Respuesta