Skip to main content
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"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developer.iobot.chat/llms.txt

Use this file to discover all available pages before exploring further.

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

​
businessId
number
required
ID del negocio al que pertenece la campaña.
​
campaignId
string
required
ID de la campaña de Meta Ads cuyos adsets se desean obtener.

​
Parámetros de consulta

​
datePreset
string
Período predefinido para las métricas de Meta. Valores aceptados: today, yesterday, last_7d, last_30d, this_month, maximum. Por defecto today.
​
accountId
string
ID de la cuenta publicitaria de Meta. Si se omite, se usa la cuenta predeterminada del negocio.
​
start
string
Fecha de inicio en formato ISO 8601. Usada para filtrar métricas de mensajes, ventas y cotizaciones.
​
end
string
Fecha de fin en formato ISO 8601. Usada para filtrar métricas de mensajes, ventas y cotizaciones.

​
Respuesta

​
data
array
Lista de adsets con sus anuncios.
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"
      }
    }
  ]
}