Delivery metrics

GET /api/marketing/insights

Synchronous query. Without object_id it measures the whole account; with it, a campaign, an ad set or an ad. fields is a CSV of metrics (by default impressions, clicks, spend, reach, frequency, CPC, CPM, CTR and actions). date_preset is accepted as a free string, not as a closed enum: Meta’s parameter reference is not fully published, so Neike passes it through as is and Meta validates it. The commonly used values are in GET /api/marketing/enums as suggestions. time_increment works the same way (free string): a number of days (1, 7, 28), monthly or all_days. 1 is the typical value for a daily series; if it is not sent, Graph aggregates the whole range in a single row. Requires the marketing:read scope.

Authentication

Send your API key in the x-neike-api-key header. Console sessions can use a bearer JWT plus x-neike-client-id instead.

Responses

Status	Description	Schema
200	—	—

Example

curl -X GET https://api.neike.dev/api/marketing/insights \
  -H "x-neike-api-key: whk_live_…"