Detalle de un conjunto de anuncios
GET /api/marketing/adsets/{adSetId}ad_account_id es obligatorio: resuelve el token y garantiza que la cuenta sea del cliente autenticado. Requiere scope marketing:read.
Responses
Section titled “Responses”| Status | Description | Schema |
|---|---|---|
200 | — | AdSetDto |
Example
Section titled “Example”curl -X GET https://api.neike.dev/api/marketing/adsets/{adSetId} \ -H "x-neike-api-key: whk_live_…"AdSetDto
Section titled “AdSetDto”| Field | Type | Description | |
|---|---|---|---|
id | string | required | Example: "120210000000000000". |
name | string | required | Example: "AR 25-45 · feed". |
campaign_id | string | optional | Example: "120210000000000000". |
status | ACTIVE · PAUSED · DELETED · ARCHIVED | optional | — |
effective_status | string | optional | Estado calculado por Meta, de solo lectura. |
daily_budget | string | optional | Presupuesto diario en centavos. Example: "50000". |
lifetime_budget | string | optional | Presupuesto total en centavos. |
billing_event | APP_INSTALLS · CLICKS · IMPRESSIONS · LINK_CLICKS · NONE · OFFER_CLAIMS · PAGE_LIKES · POST_ENGAGEMENT · THRUPLAY · PURCHASE · LISTING_INTERACTION | optional | — |
optimization_goal | NONE · APP_INSTALLS · AD_RECALL_LIFT · ENGAGED_USERS · EVENT_RESPONSES · IMPRESSIONS · LEAD_GENERATION · QUALITY_LEAD · LINK_CLICKS · OFFSITE_CONVERSIONS · PAGE_LIKES · POST_ENGAGEMENT · QUALITY_CALL · REACH · LANDING_PAGE_VIEWS · VISIT_INSTAGRAM_PROFILE · ENGAGED_PAGE_VIEWS · VALUE · THRUPLAY · DERIVED_EVENTS · APP_INSTALLS_AND_OFFSITE_CONVERSIONS · CONVERSATIONS · IN_APP_VALUE · MESSAGING_PURCHASE_CONVERSION · MESSAGING_DEEP_CONVERSATION_AND_FOLLOW · SUBSCRIBERS · REMINDERS_SET · MEANINGFUL_CALL_ATTEMPT · PROFILE_VISIT · PROFILE_AND_PAGE_ENGAGEMENT · ADVERTISER_SILOED_VALUE · AUTOMATIC_OBJECTIVE · MESSAGING_APPOINTMENT_CONVERSION | optional | — |
bid_amount | string | optional | Puja en centavos. |
bid_strategy | LOWEST_COST_WITHOUT_CAP · LOWEST_COST_WITH_BID_CAP · COST_CAP · LOWEST_COST_WITH_MIN_ROAS | optional | — |
start_time | string | optional | Example: "2026-09-01T00:00:00-0300". |
end_time | string | optional | Example: "2026-09-30T23:59:59-0300". |
targeting | object | optional | Segmentación tal como la guarda Meta. |
promoted_object | object | optional | Objeto promocionado (página, app o píxel). |
created_time | string | optional | — |
updated_time | string | optional | — |