연결된 광고 계정의 유료 캠페인을 하나의 API로
광고 계정을 한 번만 연결하면 각 네트워크와의 통신은 FoPost가 대신합니다. 반응이 좋은 게시물을 광고로 전환하고, 캠페인 구조를 관리하고, 성과가 나쁜 광고를 중지하고, 어느 네트워크에서 집행하든 같은 형식으로 인사이트를 가져오세요.
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"
}
}게시물 부스트
이미 게시한 글을 크리에이티브를 다시 만들 필요 없이 홍보합니다.
일시 중지 상태로 시작
paused: false를 전달하지 않으면 새 광고는 일시 중지 상태로 생성됩니다.
하나의 인사이트 형식
노출, 도달, 클릭, 지출, CTR, 리드를 어느 네트워크에서나 같은 형식으로 제공합니다.
팀이 이미 쓰고 있는 광고 네트워크
Meta, Google, LinkedIn, TikTok, Pinterest, X 광고 계정은 각 네트워크의 자체 로그인으로 연결됩니다. GET /v1/ads/providers는 모든 네트워크와 지원 기능을 나열하며, 부스트는 Facebook, Instagram, LinkedIn, TikTok, Pinterest, X에 게시한 글에서 사용할 수 있습니다. Google에는 홍보할 게시물이 없으므로 광고를 부스트하지 않고 직접 만듭니다.
연결 레퍼런스 읽기
네트워크별 지원 기능
각 프로바이더가 부스트, 리드 양식, 픽셀 등을 제공하는지 알려 줍니다.
기존 광고도 지원
GET /v1/ads/external은 네트워크의 자체 관리 도구에서 만든 광고를 나열합니다.
워크스페이스 단위
연결은 하나의 워크스페이스에 속하며 그 워크스페이스에서만 접근할 수 있습니다.
캠페인, 광고 세트, 광고, 크리에이티브, 오디언스
부스트만으로 부족하다면 POST /v1/ads/campaigns, /v1/ads/ad-sets, /v1/ads/ads로 전체 구조를 구성하세요. 크리에이티브와 저장된 오디언스도 함께 다룰 수 있습니다. 목표는 각 네트워크가 지원하는 범위에서 참여, 트래픽, 인지도, 동영상 조회, 메시지, 통화, WhatsApp, 판매를 포함합니다. 한 번의 호출로 최대 50개 객체를 일시 중지하거나 재개할 수 있습니다.
캠페인 엔드포인트 보기curl -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 }
]
}복제
캠페인, 광고 세트, 광고를 복사합니다. 복사본은 기본적으로 일시 중지 상태로 시작합니다.
오디언스
저장된 오디언스를 만들고 네트워크가 제공하는 타기팅 옵션을 검색합니다.
지출에는 publish 필요
집행, 부스트, 일시 중지, 삭제에는 publish 스코프가 필요합니다.
리포트 API를 하나하나 익히지 않고 성과 조회하기
GET /v1/ads/insights는 객체 ID와 날짜 범위를 받아 합계, 연령·성별·게재 위치·국가별 선택 분석, 일별 타임라인을 반환합니다. 지출은 광고 계정의 통화로 최소 단위 기준입니다. Google Ads의 경우 POST /v1/ads/insights/query가 연결된 고객에 대해 Google Ads 쿼리를 실행합니다.
인사이트 레퍼런스 읽기curl "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": []
}
}원하는 기간
since와 until은 광고 계정의 시간대를 기준으로 하며, daily=true를 추가하면 타임라인을 받습니다.
광고 새로고침
POST /v1/ads/:id/refresh로 현재 상태와 누적 수치를 가져옵니다.
최소 단위
예산과 지출은 통화의 최소 단위로 표현된 정수입니다.
리드, 광고 댓글, 전환 추적
Meta와 LinkedIn에서 리드 양식을 만들고 각 양식에 모인 리드를 조회하세요. 페이지를 구독하면 새 리드가 네트워크에서 보고되는 대로 GET /v1/ads/leads로 들어옵니다. TikTok에서는 광고에 달린 댓글을 읽고 답글을 달거나 숨길 수 있습니다. Meta, LinkedIn, TikTok의 픽셀을 관리하고 전환 이벤트를 네트워크로 다시 전송하세요.
개발 시작하기
리드 피드
구독 중인 모든 페이지의 리드를 페이지네이션된 하나의 목록으로 제공합니다.
광고 댓글
TikTok 광고용 POST /v1/ads/comments/:id/reply 및 /hide.
픽셀
픽셀을 만들고, 공유하고, 통계와 매칭 품질을 조회합니다.