V4 Marketing API
HomeAPI ReferenceChangelog
HomeAPI ReferenceChangelog
V4 Marketing
  1. Facebook Ads
  • Facebook Ads
    • Overview
    • Accounts
      GET
    • Campaigns
      GET
    • Ad Sets
      GET
    • Ads
      GET
    • Actions
      GET
    • Demographics
      GET
    • Platforms
      GET
    • Regions
      GET
    • Creatives
      GET
    • Ad Set Config
      GET
    • Campaigns Config
      GET
  • Google Ads
    • Overview
    • Accounts
      GET
    • Campaigns
      GET
    • Ad Groups
      GET
    • Ad Group Ads
      GET
    • Keywords
      GET
    • Conversions
      GET
    • Age Range
      GET
    • Gender
      GET
    • Geographic
      GET
    • Conversion Segmented Campaigns
      GET
    • Conversion Segmented Ad Groups
      GET
    • Conversion Segmented Ad Group Ads
      GET
    • Campaigns Criterion
      GET
    • Ad Group Criterion
      GET
  1. Facebook Ads

Campaigns

GET
https://api.data.v4.marketing/v1/facebook-ads/campaigns
Retrieve Facebook Ads campaigns data with performance metrics

Requisição

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200Correto
application/json
Successful response
Body

🟠400Solicitação incorreta
🔴500Erro interno do servidor
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.data.v4.marketing/v1/facebook-ads/campaigns?workspaceId=workspace_123&organizationId&userId&dateStart=2024-01-01&dateEnd=2024-12-31&page&limit&orderBy&orderDirection' \
--header 'Authorization: Bearer {token}'
Response Response Example
200 - Exemplo 1
{
    "data": [
        {
            "campaign_id": "string",
            "campaign_name": "string",
            "impressions": 0,
            "reach": 0,
            "frequency": 0,
            "clicks": 0,
            "ctr": 0,
            "inline_link_clicks": 0,
            "inline_link_click_ctr": 0,
            "spend": 0,
            "cpc": 0,
            "cpm": 0,
            "actions": "string",
            "objective": "string",
            "website_purchase_roas": 0,
            "account_id": "string",
            "date_start": "2019-08-24",
            "date_stop": "2019-08-24",
            "workspace_id": "string",
            "organization_id": "string",
            "user_id": "string",
            "document_id": "string",
            "inserted_at": "2019-08-24T14:15:22Z"
        }
    ],
    "meta": {
        "page": 0,
        "limit": 0,
        "total": 0,
        "totalPages": 0,
        "hasNextPage": true,
        "hasPreviousPage": true
    }
}
Modificado em 2025-10-30 14:27:48
Página anterior
Accounts
Próxima página
Ad Sets
Built with