Synupv1
Criar chave
v1Recursos/Connections/getListar configurações de boost

Listar configurações de boost

Retorna as configurações de boost salvas (predefinições reutilizáveis de segmentação e orçamento para impulsionar uma publicação) em uma conta conectada.

get/api/v1/connections/boost-configs
connections:read
Parâmetros de consulta
connectionIdstringobrigatório
A conta conectada a ser consultada. Obrigatório. Procure com GET /api/v1/connections.
Resposta
dataobjectopcional
boostConfigsarray of objectopcional
As configurações de boost salvas nesta conta conectada.
idstringopcional
Identificador único da configuração de boost.
connectionIdstringopcional
ID da conta conectada à qual esta configuração de boost pertence.
adAccountIdstringopcional
ID da conta de anúncios da qual esta configuração de boost gasta.
namestringopcional
Nome desta predefinição.
platformstringopcional
Plataforma em que esta configuração de boost é executada, correspondendo à sua conta conectada.
targetingobjectopcional
Configurações de segmentação para esta predefinição.
ageMinnumberopcional
Idade mínima do público.
ageMaxnumberopcional
Idade máxima do público.
gendersarray of numberopcional
Gêneros do público a segmentar: 1 para masculino, 2 para feminino.
geoLocationsobjectopcional
Segmentação geográfica: países, regiões, cidades e/ou códigos postais.
interestsarray of objectopcional
Categorias de interesse a segmentar.
publisherPlatformsarray of stringopcional
Em quais superfícies de plataforma segmentar, ex.: ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)opcional
Restringe o público a pessoas que curtem a página (fans) ou também aos amigos delas (fans_of_fans).
dailyBudgetnumberopcional
Orçamento diário, na unidade monetária menor da plataforma (ex.: centavos).
durationDaysnumberopcional
Quantos dias o boost dura quando aplicado.
delayHoursnumberopcional
Horas a esperar após a publicação de um post antes de impulsioná-lo.
publisherPlatformsarray of stringopcional
Em quais superfícies de plataforma esta predefinição impulsiona.
archivedbooleanopcional
Se esta predefinição foi arquivada.
createdAtstringopcional
Quando esta predefinição foi criada, como timestamp ISO 8601.
updatedAtstringopcional
Quando esta predefinição foi atualizada por último, como timestamp ISO 8601.
adAccountobjectopcional
Um breve resumo da conta de anúncios da qual esta predefinição gasta, ou null.
platformAccountIdstringopcional
O identificador próprio da plataforma para essa conta de anúncios.
namestringopcional
Nome de exibição dessa conta de anúncios.
currencystringopcional
Moeda em que essa conta de anúncios cobra, ou null.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/connections/boost-configs
Sua chave de API
connectionId *
{
  "data": {
    "boostConfigs": [
      {
        "id": "boost_1",
        "connectionId": "conn_1",
        "adAccountId": "adacct_1",
        "name": "Local awareness — $10/day",
        "platform": "facebook",
        "targeting": {
          "ageMin": 25,
          "ageMax": 55,
          "genders": [],
          "geoLocations": {
            "countries": [],
            "regions": [],
            "cities": [],
            "zips": []
          },
          "interests": [],
          "publisherPlatforms": [
            "facebook"
          ]
        },
        "dailyBudget": 10,
        "durationDays": 7,
        "delayHours": 0,
        "publisherPlatforms": [
          "facebook"
        ],
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}