Facebook Ads

Contas

GET
/v1/facebook/accounts

Retorna dados de contas do Facebook Ads, incluindo status da conta, saldo, informações de investimento e detalhes de configuração.

Este endpoint retorna metadados em nível de conta e informações financeiras.

Dimensões disponíveis:

  • ID da conta
  • ID interno
  • Status da conta
  • Valor investido
  • Saldo
  • Data de criação
  • Nome da conta
  • Limite de investimento

Limitações:

  • Máximo de 5000 registros por página
  • Tamanho de página padrão: 500
  • Suporta paginação

Filtros:

  • organizationId (obrigatório)
  • userId (opcional)
  • integrationName (opcional)

Autorização

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Parâmetros de query

organizationId*string

Identificador da organização (obrigatório)

userId?string

Identificador do usuário (opcional)

integrationName?string

Identificador do nome da integração (opcional)

page?integer

Número da página para paginação (opcional)

Padrão1
limit?integer

Número de itens por página (opcional, máx. 5000)

Intervalovalue <= 5000
Padrão500

Corpo da resposta

Resposta de sucesso

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/facebook/accounts?organizationId=organization_123"
{  "data": [    {      "id": "string",      "account_id": "string",      "account_status": "string",      "amount_spent": 0,      "balance": 0,      "created_time": "2019-08-24T14:15:22Z",      "name": "string",      "spend_cap": 0,      "organization_id": "string",      "user_id": "string",      "document_id": "string",      "integration_name": "string",      "inserted_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}