---
title: "Returns the list of Meta campaigns updated during a period of time."
method: GET
path: "/v2/analytics/campaigns/facebookads"
tags: ["Meta Ads Analytics Service"]
---

# Returns the list of Meta campaigns updated during a period of time.

`GET /v2/analytics/campaigns/facebookads`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/analytics/campaigns/facebookads`
- Auth: none declared

## Query parameters

- `from` string, required
- `to` string, required
- `timezone` string

## Response `200`

OK

- JsonOkListResponseMetaCampaignDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` MetaCampaignDto[]
    - `id` string: Internal campaign ID
    - `providerId` string: Provider-specific campaign ID
    - `name` string, required: Campaign name
    - `buyingType` string: Buying type for the campaign
    - `status` string: Campaign status
    - `created` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `start` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `stop` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `updated` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `impressions` number, double: Number of impressions
    - `reach` number, double: Reach of the campaign
    - `clicks` number, double: Number of clicks
    - `spent` number, double: Amount spent
    - `uniqueClicks` number, double: Unique clicks
    - `uniqueCtr` number, double: Unique click-through rate
    - `biddingStrategyType` string: Bidding strategy type
    - `budgetId` string: Budget ID
    - `budget` number, double: Budget amount
    - `budgetType` string: Budget type
    - `purchaseROAS` number, double: Purchase ROAS (Return on Ad Spend)
    - `allConversionsValue` number, double: All conversions value
    - `conversionsValue` number, double: Conversions value
    - `costPerConversion` number, double: Cost per conversion
    - `ctr` number, double: Click-through rate
    - `impressionsReach` number, double: Impressions reach
    - `country` string: Target country
    - `currency` string: Currency code
    - `conversionRate` number, double: Conversion rate
    - `results` number, double: Results count
    - `resultsLabel` string: Results label
    - `adAccount` string: Ad account ID
    - `customEventType` string: Custom event type
    - `objective` string: Campaign objective
    - `provider` string: Provider name
    - `providerCampaignId` string: Provider campaign ID
    - `conversions` number, double: Number of conversions
    - `actions` object: Actions map with action names and values
    - `cpm` number, double
    - `cpc` number, double

## Changes

- **2026-10-19** `cd0ca612fa01`: 2 info
  - api operation id `downloadCampaignsCSV` removed and replaced with `getCampaigns_1`
  - added the media type `application/json` for the response with the status `200`
- **2026-10-19** `6bd5f8435492`: 1 breaking, 1 info
  - removed the media type `application/json` for the response with the status `200`
  - api operation id `getCampaigns_1` removed and replaced with `downloadCampaignsCSV`
- **2026-10-19** `28c3aa47609c`: 2 info
  - api operation id `downloadCampaignsCSV` removed and replaced with `getCampaigns_1`
  - added the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/metricool/apis/metricool-api/changes/v2/analytics/campaigns/facebookads/get.md)

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)