Taboola API 가이드: Backstage 엔드포인트, 인증 및 실제 활용 사례

Taboola API — 공식적으로 Backstage API — 는 광고주를 위한 Taboola의 REST 인터페이스입니다. OAuth 2.0 클라이언트 자격 증명으로 인증한 후, Ads Console에서 조작할 수 있는 모든 것(캠페인, 크리에이티브 아이템, 타겟팅, 예산, 성과 보고서)을 읽고 쓸 수 있으며, 모두 https://backstage.taboola.com/backstage/api/1.0/{account_id}/… 아래에 있습니다. 미디어 구매자들이 입찰 및 예산 변경을 자동화하고, 크리에이티브를 대량 업로드하고, 지출을 데이터 웨어하우스에 동기화하고, Taboola UI가 제공하지 않는 규칙 엔진을 구축하는 데 사용하는 계층입니다. 의도적으로 노출하지 않는 것은 다른 사람의 데이터입니다 — 네트워크의 경쟁적 관점을 위해서는 완전히 다른 API가 필요하며, 이에 대해서는 마지막에 다룹니다.

Backstage API가 다루는 것#

Backstage는 광고주 콘솔을 거의 1:1로 반영합니다. 실제로는 네 가지 영역이 대부분의 작업을 수행합니다:

• 캠페인 관리. 캠페인 생성, 읽기, 업데이트, 일시 중지; CPC, 일일 및 총 예산, 지역/플랫폼 타겟팅, 사이트 차단 설정. 야간 수치를 확인한 후 오전 7시에 수동으로 변경하던 모든 작업을 스크립트로 대체할 수 있습니다.
• 아이템(크리에이티브). 각 캠페인에는 실제로 게재되는 이미지+헤드라인 단위인 아이템이 포함됩니다. API를 사용하면 아이템을 대량으로 추가하고, 상태를 업데이트하고, 개별 아이템의 검토 상태를 읽을 수 있습니다. 이를 통해 대규모 계정은 UI를 건드리지 않고도 수십 가지 크리에이티브 변형을 출시합니다. (아직 첫 캠페인을 수동으로 설정 중이라면 Taboola 캠페인 설정 가이드부터 시작하세요 — API는 콘솔 개념을 이미 알고 있다고 가정합니다.)
• 보고. 차원별로 분류된 집계 성능 엔드포인트 — 일, 캠페인, 사이트, 국가, 플랫폼, 아이템 — 모든 자동화 최적화의 원자재입니다.
• 사전. 다른 모든 것이 의존하는 열거형에 대한 조회 엔드포인트: 국가 코드, 플랫폼, 오디언스 세그먼트.

접근은 계정에 대해 발급된 클라이언트 ID와 시크릿으로 제공되며, 일반적으로 Taboola 계정 관리자를 통해 요청합니다. 공식 Backstage 참조는 현재 엔드포인트 형태와 접근 절차에 대한 진실의 원천입니다. 아래의 엔드포인트 경로는 작성 시점 기준이며, 구축하기 전에 참조 문서와 대조 확인하세요.

인증: 클라이언트 자격 증명에서 베어러 토큰으로#

Backstage는 표준 OAuth 2.0 클라이언트 자격 증명 흐름을 사용합니다. ID와 시크릿을 토큰으로 교환하세요:

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

응답에는 모든 호출에서 베어러 헤더로 전송하는 access_token이 포함됩니다:

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

allowed-accounts 호출은 올바른 첫 번째 요청입니다. 다른 모든 엔드포인트가 경로에 필요로 하는 account_id 값(숫자 ID 및 읽을 수 있는 이름)을 반환합니다. 토큰은 만료되므로, 요청마다 새 토큰을 발행하는 대신 하나를 캐시하고 401 응답 시 갱신하세요. 이는 지연 시간과 토큰 요청이 데이터 요청보다 더 엄격하게 속도 제한되기 때문입니다.

실제로 사용할 엔드포인트#

보고 엔드포인트는 start_date 및 end_date 쿼리 매개변수와 선택적 필터를 사용하며, dimension 세그먼트(day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…)가 슬라이스를 결정합니다. site_breakdown은 최적화에 가장 중요한 것으로, 차단 목록 자동화를 구동하는 게시자별 성과 피드입니다.

미디어 구매자가 실제로 자동화하는 것#

API는 설정 비용을 네 가지 반복 작업으로 회수합니다:

1. 규칙 엔진. 전형적인 예: 매시간 활성 캠페인의 site_breakdown을 가져와서, 타겟 CPA의 N배 이상을 지출했지만 전환이 0인 사이트를 캠페인 업데이트를 통해 차단 사이트 목록에 추가합니다. 이는 모든 진지한 Taboola 광고주가 수동으로 수행하는 손실 제거 루프를 코드화한 것으로, 감정 없이 오전 3시에 실행됩니다.
2. 입찰 관리. 목표를 초과하는 날짜와 지역에서 캠페인 CPC(및 사용 가능한 경우 사이트별 입찰 수정자)를 높이고, CPA가 벗어날 때 낮추는 — 작고 빈번하며 지루하지만 복리 효과가 있는 조정.
3. 대량 크리에이티브 작업. 캠페인당 30개의 헤드라인/이미지 변형을 업로드하고, 매주 중간 CTR 미만의 모든 항목을 일시 중지하며, 한낮의 클릭 작업 없이 크리에이티브 피로에 앞서 회전을 유지.
4. 지출 파이프라인. 야간 작업으로 campaign-summary를 일별로 웨어하우스에 가져와서, Taboola 지출이 전환 수익 및 다른 모든 채널과 함께 하나의 대시보드에 표시되도록 합니다.

최소 통합 계획#

처음부터 시작하는 경우, 이 순서를 따라 하루 정도 작업으로 유용한 자동화를 달성할 수 있으며, 각 단계는 다음 단계 전에 확인 가능합니다:

1. 토큰 왕복. 자격 증명을 토큰으로 교환하고 allowed-accounts를 호출합니다. 작동하면 인증 및 권한이 해결됩니다.
2. 읽기 전용 보고. 지난 주의 일별 campaign-summary를 가져와서 Ads Console의 수치와 대조합니다. 읽기가 UI에 표시된 것과 일치할 때까지 아무것도 쓰지 마십시오.
3. 단일 안전한 변경. PUT을 통해 하나의 테스트 캠페인을 일시 중지 및 해제합니다. 변경 사항이 콘솔에 나타나고 게재 상태가 따르는지 확인합니다.
4. 야간 지출 동기화. 보고서 풀을 데이터베이스로 예약합니다. 이 작업만으로도 대부분의 팀에 통합이 정당화됩니다.
5. 규칙 엔진, 드라이 런. 사이트 차단 결정을 계산하고 쓰기 전에 일주일 동안 어떤 일이 일어날지 기록합니다. 그 결정을 수동으로 내리는 것과 비교하는 것은 가장 저렴한 QA입니다.

5단계로 바로 건너뛰는 것은 일반적인 실수입니다. 라이브 광고 계정에 대한 쓰기 경로 버그는 값비싼 교훈입니다.

속도 제한 및 실용적인 주의 사항#

• 한계를 존중하세요. Backstage는 계정별 속도 제한을 적용합니다. 읽기를 배치 처리하고(캠페인당 분당 한 번이 아니라 시간당 한 번의 보고서 호출), 429 응답 시 백오프하세요. 가정하지 말고 참조 문서에서 현재 제한을 확인하세요.
• 보고는 게재보다 지연됩니다. 최근 시간의 데이터는 시간이 지나면서 안정화됩니다. 최소 몇 시간 전의 데이터를 기준으로 규칙을 구축하세요. 그렇지 않으면 불완전한 수치로 캠페인을 일시 중지할 수 있습니다.
• 편집은 즉시 적용되지 않습니다. 캠페인 변경 사항은 지연되어 게재에 전파되며, 아이템 편집은 검토를 다시 트리거할 수 있습니다. 자동화는 '실패한' 쓰기를 다시 발행하기보다는 지연을 허용해야 합니다.
• ID를 저장하고 이름은 저장하지 마세요. 캠페인 및 아이템 이름은 사람이 편집할 수 있습니다. 숫자 ID는 안정적인 조인 키입니다.
• 쓰기 경로를 보호하세요. 버그가 있는 규칙 엔진은 계정의 전체 지출을 중지시키거나 입찰을 10배로 올릴 수 있습니다. 모든 변경을 기록하고, 합리적인 경계를 추가하고(한 번에 입찰을 X% 이상 변경하지 않음), 모든 새 규칙을 드라이 런 모드로 시작하세요.

다른 Taboola API: 경쟁 데이터#

위의 모든 것은 정확히 하나의 계정, 즉 귀하의 계정만 봅니다. Backstage는 어떤 광고주가 귀하의 버티컬에서 확장하고 있는지, 어떤 크리에이티브를 실행하고 있는지, 또는 경쟁사의 캠페인이 얼마나 오래 지속되었는지 알려주지 않습니다. 네트워크는 자체 광고 라이브러리를 게시하지 않으며, 공식 엔드포인트가 다른 광고주의 활동을 노출하지 않습니다.

이것이 OpenAdLibrary의 개발자 API가 메우는 격차입니다. 인덱스는 49개 네트워크에 걸친 725,000개 이상의 네이티브 광고 코퍼스 내에 206,000개 이상의 활성 Taboola 크리에이티브(2026년 7월 기준)를 보유하고 있으며, Taboola 광고 라이브러리 뒤에 있는 동일한 데이터를 REST를 통해 쿼리할 수 있습니다: 광고주, 버티컬, 지역, 수명별로 크리에이티브 검색; 헤드라인 및 랜딩 페이지 가져오기; 경쟁사가 캠페인을 시작하고 종료하는 시점 추적. 네이티브 광고 데이터 API 가이드는 엔드포인트를 문서화하며, 워크플로가 LLM 에이전트에 있는 경우 MCP 서버가 Claude 및 ChatGPT를 위한 도구로 동일한 코퍼스를 노출합니다. 무료 키로 가벼운 사용이 가능하며, 가격은 나머지에 대해 일정하게 유지됩니다. 프로그래매틱 광고 인텔리전스 접근의 더 넓은 환경은 API가 있는 광고 스파이 도구에서 조사됩니다.

두 API는 자연스럽게 구성됩니다: Backstage는 계정에서 실행을 자동화하고, 인텔리전스 API는 다른 모든 사람의 연구를 자동화합니다. 자동화를 최대한 활용하는 구매자는 두 가지를 모두 실행합니다 — 자신의 캠페인을 정리하는 규칙 엔진과 새 광고주가 버티컬에서 확장을 시작할 때 플래그를 지정하는 경쟁 피드로, 다음 테스트가 절대 맹목적으로 선택되지 않도록 합니다. Taboola 스파이 도구로 브라우저에서 경쟁 코퍼스를 확인한 후, 워크플로가 입증되면 동일한 쿼리를 프로그래매틱 방식으로 가져가세요.