Campanhas pagas nas suas contas de anúncios conectadas, por uma única API
Conecte uma conta de anúncios uma vez e o FoPost fala com cada rede por você. Transforme um post que está indo bem em anúncio, gerencie a árvore de campanhas, pause o que não funciona e obtenha métricas em um único formato, seja qual for a rede que veicula o anúncio.
curl -X POST https://api.fopost.com/v1/ads/boost \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "9b2f6c1e-...",
"connectionId": "3f6a9d27-...",
"adAccountId": "act_1234567890",
"postId": "7d3e0a52-...",
"accountId": "4a71d80b-...",
"name": "Boost: launch day",
"goal": "engagement",
"budget": { "minor": 2000, "type": "daily" },
"targeting": { "countries": ["US", "CA"], "ageMin": 25, "ageMax": 54, "gender": "all" }
}'
{
"data": {
"id": "c1d8e4b6-...", "kind": "boost", "name": "Boost: launch day", "goal": "engagement",
"status": "paused", "effectiveStatus": "PAUSED", "platform": "instagram-business",
"sourcePostId": "7d3e0a52-...", "budgetMinor": 2000, "budgetType": "daily",
"currency": "USD", "insights": null, "lastError": null, "createdAt": "2026-11-12T10:04:51Z"
}
}Impulsione um post
Promova um post já publicado, sem refazer o criativo.
Começa pausado
Novos anúncios são criados pausados, a menos que você passe paused: false.
Um único formato de métricas
Impressões, alcance, cliques, gasto, CTR e leads, iguais em todas as redes.
As redes de anúncios que sua equipe já usa
Contas de anúncios de Meta, Google, LinkedIn, TikTok, Pinterest e X se conectam pelo login de cada rede. GET /v1/ads/providers lista cada rede com o que ela suporta, e o impulsionamento funciona para posts publicados no Facebook, Instagram, LinkedIn, TikTok, Pinterest e X. O Google não tem post para promover, então seus anúncios são criados, não impulsionados.
Leia a referência de conexões
Recursos por rede
Cada provedor informa se oferece impulsionamento, formulários de leads, pixels e mais.
Anúncios existentes também
GET /v1/ads/external lista anúncios criados no gerenciador da própria rede.
Restrito ao workspace
Uma conexão pertence a um workspace e só é acessível a partir dele.
Campanhas, conjuntos de anúncios, anúncios, criativos e públicos
Quando um impulsionamento não basta, crie a árvore completa: POST /v1/ads/campaigns, /v1/ads/ad-sets e /v1/ads/ads, com criativos e públicos salvos ao lado. Os objetivos cobrem engajamento, tráfego, reconhecimento, visualizações de vídeo, mensagens, ligações, WhatsApp e vendas, conforme cada rede os suporta. Pause ou retome até 50 objetos em uma única chamada.
Veja os endpoints de campanhacurl -X POST https://api.fopost.com/v1/ads/status \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "9b2f6c1e-...",
"connectionId": "3f6a9d27-...",
"status": "paused",
"objects": [
{ "id": "120210000000001", "level": "campaign" },
{ "id": "120210000000042", "level": "ad_set" }
]
}'
{
"data": [
{ "id": "120210000000001", "level": "campaign", "ok": true, "error": null },
{ "id": "120210000000042", "level": "ad_set", "ok": true, "error": null }
]
}Duplicar
Copie uma campanha, conjunto de anúncios ou anúncio. As cópias começam pausadas por padrão.
Públicos
Crie públicos salvos e pesquise as opções de segmentação que a rede oferece.
Gasto exige publish
Lançar, impulsionar, pausar ou excluir exige o escopo publish.
Leia resultados sem aprender cada API de relatórios
GET /v1/ads/insights recebe um id de objeto e um intervalo de datas e retorna totais, uma quebra opcional por idade, gênero, posicionamento ou país e uma linha do tempo diária. O gasto está na moeda da conta de anúncios, em unidades menores. Para o Google Ads, POST /v1/ads/insights/query executa uma consulta do Google Ads no cliente conectado.
Leia a referência de métricascurl "https://api.fopost.com/v1/ads/insights?workspace_id=9b2f6c1e-...&connection_id=3f6a9d27-...&object_id=120210000000001&since=2026-11-01&until=2026-11-11&breakdown=country" \
-H "X-API-Key: $API_KEY"
{
"data": {
"objectId": "120210000000001", "currency": "USD",
"since": "2026-11-01", "until": "2026-11-11", "breakdownBy": "country",
"totals": { "impressions": 48210, "reach": 31977, "clicks": 1204, "spendMinor": 22000, "ctr": 2.5, "leads": 0 },
"breakdown": [{ "key": "US", "metrics": { "impressions": 39102, "clicks": 1003, ... } }],
"timeline": []
}
}Qualquer intervalo de datas
since e until no fuso horário da conta de anúncios; adicione daily=true para uma linha do tempo.
Atualize um anúncio
POST /v1/ads/:id/refresh busca o status atual e os números acumulados.
Unidades menores
Orçamentos e gastos são inteiros na menor unidade da moeda.
Leads, comentários em anúncios e rastreamento de conversões
Crie formulários de leads no Meta e no LinkedIn e leia os leads que cada formulário coleta. Assine uma Página e os novos leads chegam em GET /v1/ads/leads conforme a rede os reporta. No TikTok, leia os comentários de um anúncio e responda ou oculte. Gerencie pixels no Meta, LinkedIn e TikTok e envie eventos de conversão de volta para a rede.
Comece a construir
Feed de leads
Uma lista paginada de leads de todas as Páginas assinadas.
Comentários em anúncios
POST /v1/ads/comments/:id/reply e /hide em anúncios do TikTok.
Pixels
Crie, compartilhe e leia estatísticas e qualidade de correspondência de um pixel.
Perguntas sobre API de Anúncios, respondidas
Quais redes de anúncios são suportadas?
Uma chamada de API pode começar a gastar dinheiro?
Quem paga pelos anúncios?
Posso gerenciar anúncios que criei em outro lugar?
De quais escopos de chave de API eu preciso?
Existe limite de requisições?
Comece a construir com API de Anúncios hoje
Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.
Obtenha sua chave de API