TikTok広告のレポートを自動化しようとすると、GoogleやMetaと同じつもりで進めて最初の審査で止まります。APIの入口に「会社としての審査」が置かれている一方で、いったん通ればアクセストークンは無期限。Metaのようなトークン失効との戦いはありません。入口が重くて運用が軽い、という構造です。
もう1つの特徴は、レポートAPIの仕様が細かく決まっていることです。日別データは1リクエスト30日まで、数値はすべて文字列で返る、CVは後から増える。知らずに作ると必ず踏む仕様が並んでいます。
それぞれのやり方の設定手順と限界、本命のMarketing API直連携の審査を通すコツから無期限トークンの取得、レポート取得の実コード、さらに集めたデータをAIにつないで分析まで自動化する方法までを、2026年7月時点の公式ドキュメントに沿って順に見ていきます。
先に結論です。
Metaと同じく「スクリプト」という中間のやり方はありません。コードを書くならAPI直行です。
広告マネージャーのカスタムレポートには、スケジュール実行（Scheduled running）があります。頻度は毎日・毎週・月初・月末から選べ、最大5つのメールアドレスにCSVまたはXLSXを自動送付できます。配信時刻は広告アカウントのタイムゾーンで朝5〜6時ごろが目安です（公式SLAは公表なし・実運用ベース）。
地味な落とし穴が1つ。3か月間誰もレポートをダウンロードしないと、配信が自動停止する仕様です。「メールで受け取って眺めるだけ」の運用だと気づかないうちに止まるので、定期的に開く習慣か、停止時に気づける体制をセットにしてください。
実装なしでBigQueryやLooker Studioに流すなら、有料ツールです。構図はMetaと同じで、Looker StudioのTikTok公式コネクタはありません。
ツール費用の対価は、この後説明するAPI審査・仕様制約・型変換をすべて肩代わりしてくれることです。ツール比較の全体像は広告レポート自動化ツール比較｜主要9ツールの料金・対応媒体・選び方にまとめています。
無料で完結し、自由度も最大のやり方です。現行バージョンはv1.3（ベースURL https://business-api.tiktok.com/open_api/v1.3）。利用開始までの流れはこうなります。
TikTokのAPIで最初の山は実装ではなく審査です。チェックされるのは「実在する会社か」で、事前に次の条件を満たしていることを確認してください。
taro@yourcompany.co.jp。Gmail・Yahoo・iCloudなどのフリーメール、および ~.wixsite.com のような無料サブドメインは却下されます）準備できたら、以下の手順で登録します。
https://business-api.tiktok.com/portal を開きますLog in（ログイン）ボタンをクリックし、TikTok for Businessアカウントでログインします。TikTok for Businessアカウントがない場合は、同じログイン画面下部の Sign up から会社ドメインのメールアドレスで新規作成します（この段階でフリーメールを入れると次のステップで詰みます。作成時にはパスワード設定に加え、メール認証コード入力とSMS認証コード入力の2段階を求められます）Register ボタン、または画面右上のアバターアイコン → Developer info → Register をクリックしますCompany / Organization name: 登記されている法人名（例: Evast Inc.）Company website: 事業内容が分かる自社サイトのトップURL（例: https://evast.jp）。上のメールと必ず同一ドメインにすることBusiness email: 会社ドメインのメールアドレスCountry/Region: JapanIndustry: 自社の該当業種（例: Marketing & Advertising）Use case: 用意しておいた利用目的の説明文を貼り付けSubmit ボタンをクリック。送信直後に画面上部に「Your application is under review」と表示されれば申請成功です。同じ内容が登録メールにも届きます[TikTok API for Business] Developer registration result）※TikTokは公式SLAを公表していないため実務ベースの目安です。承認されるとポータル右上のバッジが Registered developer に変わります※画面表記はTikTok側の更新でバージョンによって差異が出る場合があります。ラベルが微妙に違っても、意味が対応していれば問題ありません。
開発者登録が承認されたら、次に「アプリ」を作ります。アプリ単位で App ID と Secret、認可URL、レート制限枠が発行されます。
https://business-api.tiktok.com/portal にログインした状態で、画面左サイドバーの My Apps をクリックします+ Create an app ボタンをクリックしますApp name: 任意の識別名（例: evast-tiktok-report）。あとから広告主に見える名前なので、社名を含めて分かりやすくしますApp description: アプリの機能を1〜3文で（例: Fetches daily ad performance (spend, impressions, clicks, conversions) for our own TikTok Ads accounts and stores it in BigQuery for internal dashboards.）Advertiser Redirect URL: OAuth認可後にリダイレクトされるURL。HTTPS必須・絶対URL・クエリパラメータ不可です。本番URLが未定なら、いったん https://example.com/callback と入力してください（後から Edit で変更可能）。localhostは登録不可なので、ローカル検証時はngrokなどでHTTPS化するか、ダミーURLに来た auth_code をブラウザのアドレスバーからコピペする運用にしますScope of Permission: レポート取得だけなら以下2つにチェックを入れれば十分です。Ad Account Management → Ad Account Information（読み取り）Reporting → Ads Reporting（読み取り）Confirm をクリック。確認モーダルが出るのでもう一度 Confirm をクリックしますStatus 列が Under review になれば申請成功です。概ね2〜3営業日で承認されると In service に変わります（TikTokは公式SLA未公表・実務ベースの目安）Secret は初回表示のみコピー可能な場合があるので、その場でメモしてシークレットマネージャに保存してください。App ID: 19桁前後の数字（実装上そう見えることが多いだけで公式仕様ではありません）Secret: 40文字程度の英数字Advertiser authorization URL: 手順3で広告主に開いてもらう認可URL（https://business-api.tiktok.com/portal/auth?app_id=...&state=...&redirect_uri=... の形式）。※このURLは In service 承認後にのみ有効です。審査中は表示されていてもクリックしないでください（もしくは後述のSandbox用URLを使ってください）なお、Sandbox環境はアプリ詳細画面上部の Sandbox タブから作成できます。+ Create Sandbox をクリックすると審査不要でSandbox広告アカウント（モックデータ入り）が発行され、本番審査を待つ間に実装を先に進められます。Sandbox作成直後の画面で専用の access_token が発行されるので、その場でコピーしてシークレットマネージャに保存してください。BASE URLは本番と同じ https://business-api.tiktok.com/open_api/v1.3 で、advertiser_id にSandbox用のIDを渡せば本番と同じコードで動きます。本番承認後は access_token と advertiser_id を差し替えるだけで移行できます。
アプリ詳細画面の Advertiser authorization URL を、実際に運用したい広告アカウントの管理者権限を持つユーザーに開いてもらいます。
Confirm をクリックしますConfirm をクリック。手順2で登録した Advertiser Redirect URL にリダイレクトされ、URLのクエリパラメータに auth_code=XXXX&state=YYYY が付いた状態でブラウザに表示されますhttps://example.com/callback）を登録した場合、リダイレクト先は404画面になりますがこれは正常です。ブラウザのアドレスバーに表示されているURL全体（例: https://example.com/callback?auth_code=abc123xyz&state=xyz789）をコピーし、auth_code= と &state= の間の文字列（この例では abc123xyz）だけを取り出してくださいauth_code は30分で失効し、1回しか使えません（TikTok公式仕様: The auth_code expires in 30 minutes and can be used only once）。取得したらすぐに次のトークン交換を実行してくださいトークン交換は POST /oauth2/access_token/ にJSONで投げます。まずはcurlで動作確認する例です。
curl -L -X POST 'https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/' \
-H 'Content-Type: application/json' \
-d '{
"app_id": "YOUR_APP_ID",
"secret": "YOUR_APP_SECRET",
"auth_code": "AUTH_CODE_FROM_REDIRECT"
}'成功すると次のようなJSONが返ります。
{
"code": 0,
"message": "OK",
"data": {
"access_token": "abcdef0123456789...",
"advertiser_ids": ["1234567890123456789"],
"scope": [4]
}
}data.access_token が無期限のアクセストークンです。公式ドキュメントに「The token does not expire.」と明記されており、Metaの60日長期トークンのような定期更新は不要です。裏を返すと漏洩時のリスクは大きい。以下を守ってください。
curl -L -X POST 'https://business-api.tiktok.com/open_api/v1.3/oauth2/revoke_token/' \
-H 'Content-Type: application/json' \
-d '{
"app_id": "YOUR_APP_ID",
"secret": "YOUR_APP_SECRET",
"access_token": "REVOKE_TARGET_ACCESS_TOKEN"
}'なお、レスポンスの scope は付与された権限の内部コードで、4 は Ads Reporting、100 は Ad Account Information に相当します。手順2でチェックを入れたスコープの数だけ配列に入っていれば正しい状態です。
data.advertiser_ids が、このトークンで叩ける広告主IDのリストです。この値は次のレポート取得で必須なのでトークンとセットで保存してください。
トークンと advertiser_id が揃えば、あとはレポートAPIを叩くだけです。同期エンドポイント1本が基本で、キャンペーン別×日別の主要指標を取る例がこちらです。
（A）curlで動作確認
curl -G 'https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/' \
-H 'Access-Token: YOUR_ACCESS_TOKEN' \
--data-urlencode 'advertiser_id=1234567890123456789' \
--data-urlencode 'report_type=BASIC' \
--data-urlencode 'data_level=AUCTION_CAMPAIGN' \
--data-urlencode 'dimensions=["campaign_id","stat_time_day"]' \
--data-urlencode 'metrics=["campaign_name","spend","impressions","clicks","conversion","cost_per_conversion"]' \
--data-urlencode 'start_date=2026-07-01' \
--data-urlencode 'end_date=2026-07-28' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=200'{"code": 0, "message": "OK", "data": {"list": [...], "page_info": {...}}} が返れば成功です。code が0以外なら message にエラー内容が入ります。
独特な仕様は次の3つ。
Authorization: Bearer ではなく Access-Token（この名前のカスタムヘッダー）を使う--data-urlencode が自動でやってくれます）data_level と dimensions の整合が必須。AUCTION_CAMPAIGN なら campaign_id を、AUCTION_AD なら ad_id を必ずdimensionsに含めないと code: 40002 で弾かれる（B）Pythonでコピペ実行できる完全形
以下は requests だけで動きます。ターミナルで次のようにセットアップします。
# Python 3.9以上を推奨。仮想環境で実行してください
python3 -m venv .venv
source .venv/bin/activate # Windowsは .venv\Scripts\activate
pip install requests以下を fetch_tiktok_report.py として保存します。
"""TikTok Marketing API v1.3 で日別キャンペーンレポートを取得する最小例。
使い方:
1. 下記 2 つの環境変数をセットする
export TIKTOK_ACCESS_TOKEN="手順3で取得した access_token"
export TIKTOK_ADVERTISER_ID="advertiser_ids の1つ"
2. python fetch_tiktok_report.py
"""
import os
import json
import time
import requests
BASE = "https://business-api.tiktok.com/open_api/v1.3"
# ▼▼ 書き換え箇所（環境変数に置くのが安全） ▼▼
TOKEN = os.environ.get("TIKTOK_ACCESS_TOKEN", "YOUR_ACCESS_TOKEN")
ADVERTISER_ID = os.environ.get("TIKTOK_ADVERTISER_ID", "1234567890123456789")
# ▲▲ 書き換え箇所ここまで ▲▲
def fetch_daily_campaign_report(start_date: str, end_date: str):
"""start_date〜end_date（YYYY-MM-DD, 最大30日）のキャンペーン別×日別レポート。"""
rows, page = [], 1
while True:
r = requests.get(
f"{BASE}/report/integrated/get/",
headers={"Access-Token": TOKEN},
params={
"advertiser_id": ADVERTISER_ID,
"report_type": "BASIC",
"data_level": "AUCTION_CAMPAIGN",
"dimensions": json.dumps(["campaign_id", "stat_time_day"]),
"metrics": json.dumps([
"campaign_name", "spend", "impressions",
"clicks", "conversion", "cost_per_conversion",
]),
"start_date": start_date,
"end_date": end_date,
"page": page,
"page_size": 200,
},
timeout=60,
)
# HTTPレベルのエラー（401/429/5xx など）
if r.status_code != 200:
raise RuntimeError(f"HTTP {r.status_code}: {r.text}")
body = r.json()
# アプリケーションレベルのエラー（TikTokは常に200を返し、code!=0で失敗を示す）
if body.get("code") != 0:
raise RuntimeError(f'TikTok API error {body["code"]}: {body["message"]}')
rows += body["data"]["list"]
total_page = body["data"]["page_info"]["total_page"]
if page >= total_page:
return rows
page += 1
time.sleep(0.2) # 10QPS制限に配慮した控えめなウェイト
if __name__ == "__main__":
# 例: 2026年7月分（30日以内）
result = fetch_daily_campaign_report("2026-07-01", "2026-07-28")
print(f"取得件数: {len(result)}")
# metricsの値はすべて文字列で返る。集計する場合は float() / int() 変換必須
for row in result[:3]:
d = row["dimensions"]
m = row["metrics"]
print(f"{d['stat_time_day']} camp={d['campaign_id']} "
f"spend={float(m['spend']):.0f}円 CV={float(m['conversion']):.0f}")実行します。
export TIKTOK_ACCESS_TOKEN="abcdef0123456789..."
export TIKTOK_ADVERTISER_ID="1234567890123456789"
python fetch_tiktok_report.py取得件数: 84 のように件数が出て、3行分のサンプルが表示されれば成功です。配信実績のない広告アカウントや期間を指定した場合は 取得件数: 0 で終了しますが、エラーが出ずに終わっていれば認証・パラメータともに正しく通っている合図です。実データを見たい場合は、配信実績のあるアカウントIDと期間で再実行してください。
（C）GASでスプレッドシートに書き出す場合
先にGoogleスプレッドシートを新規作成してください（https://sheets.new が最短）。開いたスプレッドシートのメニューから 拡張機能 → Apps Script をクリックすると、そのシートに紐づいた（コンテナバインドの）Apps Scriptエディタが開きます。※ここで https://script.google.com から「新しいプロジェクト」を作ってしまうと、後述の SpreadsheetApp.getActiveSpreadsheet() が null を返し TypeError になるので、必ずスプレッドシート側の拡張機能から開いてください。
エディタが開いたら、以下を貼り付けます。トークンはコード内に直書きせず、エディタ左サイドバーの歯車アイコン プロジェクトの設定 → 下部 スクリプト プロパティ → スクリプト プロパティを追加 で、TIKTOK_ACCESS_TOKEN と TIKTOK_ADVERTISER_ID の2つを登録してください。
function fetchTikTokDailyReport() {
const props = PropertiesService.getScriptProperties();
const token = props.getProperty('TIKTOK_ACCESS_TOKEN');
const advertiserId = props.getProperty('TIKTOK_ADVERTISER_ID');
const params = {
advertiser_id: advertiserId,
report_type: 'BASIC',
data_level: 'AUCTION_CAMPAIGN',
dimensions: JSON.stringify(['campaign_id', 'stat_time_day']),
metrics: JSON.stringify(['campaign_name', 'spend', 'impressions', 'clicks', 'conversion', 'cost_per_conversion']),
start_date: '2026-07-01',
end_date: '2026-07-28',
page: 1,
page_size: 200,
};
const qs = Object.entries(params)
.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
.join('&');
const url = `https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/?${qs}`;
const res = UrlFetchApp.fetch(url, {
headers: { 'Access-Token': token },
muteHttpExceptions: true,
});
const body = JSON.parse(res.getContentText());
if (body.code !== 0) throw new Error(`TikTok API error ${body.code}: ${body.message}`);
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
sheet.clear();
sheet.appendRow(['date', 'campaign_id', 'campaign_name', 'spend', 'impressions', 'clicks', 'conversion', 'cpa']);
body.data.list.forEach((row) => {
const d = row.dimensions,
m = row.metrics;
sheet.appendRow([
d.stat_time_day,
d.campaign_id,
m.campaign_name,
Number(m.spend),
Number(m.impressions),
Number(m.clicks),
Number(m.conversion),
Number(m.cost_per_conversion),
]);
});
}エディタ上部の関数選択で fetchTikTokDailyReport を選び、実行 ボタンをクリック。初回のみ「承認が必要」ダイアログが出るので、権限を確認 → 自分のGoogleアカウントを選択 → 詳細 → （プロジェクト名）に移動 → 許可 の順にクリックします。承認画面では 外部URLへの接続（UrlFetchApp） と スプレッドシートの表示・編集 の2つのスコープをまとめて求められるので、両方を許可してください。アクティブなシートに1行目ヘッダー＋日別行が書き込まれれば成功です。
日次のキャンペーンレポート程度であれば、同期エンドポイント1本で完結します。広告単位で1年分のデータをまとめて取りたくなった時点で、非同期レポート（/report/task/create/ → /report/task/check/ → /report/task/download/ の3段構え）の申請を検討してください（TikTokのドキュメントに「別途申請が必要」と案内されており、実務でも許可制で運用されているようです）。
数字が自動で集まるようになったら、分析もAIに任せられます。TikTokで特に価値が出るのは、クリエイティブの疲弊（フリークエンシー上昇とCTR低下）をAIに監視させる使い方です。取得した広告別×日別のCSVをChatGPT・Gemini・Claudeに渡し、こう指示します。
添付はTikTok広告の広告別・日別実績（過去30日）です。
1. CTRが低下傾向にあり、差し替えを検討すべき広告
2. 配信を伸ばすべき広告と、その根拠
3. 全体のCPA推移から読み取れる注意点
を、数字を引用しながら簡潔にまとめてください。TikTokはクリエイティブの消耗が他媒体より速いため、この監視を週次で回すだけでも成果が変わります。
やり方2・3でBigQueryに蓄積している場合は、「SQLで前日分を集計→生成AIのAPIに考察を書かせる→Slackに配信」という日次パイプラインまで組めます。組み方は他媒体と同じで、コツも同じ。生データを丸投げせず、集計してから渡す。TikTokは数値が文字列で返る仕様もあるため、型変換と集計を済ませたきれいな数十行を渡すのが精度への近道です。
こうしたAI分析・異常検知を既製で載せたい場合は、私たちのアドヨミAIのように、広告データのBigQuery集約とAI考察をセットで提供するサービスという選択肢もあります。
公式ドキュメントに書いてはあるものの、作ってみて初めて効いてくるポイントです。
数値がぜんぶ文字列で返る。spend も clicks も "34" のような文字列です。型変換せずにBigQueryへ流し込んで集計が壊れるのは定番なので、取り込み時に数値化を挟みます。
日別取得は1リクエスト30日まで。stat_time_day を含めると期間上限が30日になります。時間ディメンションを含めない合計値なら最大90日までを1リクエストで取得可能です（start_date 〜 end_date に指定できる期間の絶対上限自体は365日ですが、これは複数リクエストに分けたときの累計上限）。過去1年分の日別データが欲しければ、30日ずつ12回に分けてループする実装が必要です。
CVが後から増える。標準の conversion は、CV発生日ではなく広告に接触した日に紐づけて計上されるため、アトリビューション期間内は過去日の数字が遡って増えます。蓄積するなら直近30日程度を毎回洗い替える設計にし、CV発生日ベースが必要なら real_time_conversion を使います。Google（クリック日計上）とも管理画面の見え方とも混同しやすい、TikTok特有の癖です。
前日分は翌朝9時以降に取る。リアルタイムデータには通常30分〜2時間程度の遅延があり、一部ディメンションでは半日以上遅れて確定するケースも報告されています（TikTok公式に明示的な数値記載は見当たらず、実運用ベースの目安）。日次バッチはアカウントのタイムゾーンで朝9時以降が安全です。
レート制限はアプリ単位。デフォルト（Basic）は一般に10QPSと言及されており、広告アカウント単位ではなくアプリ単位の共有枠として運用されます（日次上限の具体値はTikTokが公表していないため、実測ベースで把握するのが安全です）。代理店が1つのアプリで数十アカウントを回すと枠を食い合うので、リクエストの時間分散か、上位レベルへの引き上げ申請を検討します。
シリーズ4媒体で比べると、TikTokは「入口が最も重く、運用が最も軽い」媒体です。Googleは開発者トークン、Yahoo!は法人のAPI申し込み、Metaはアプリ作成だけで入れる代わりにトークン管理が重いのに対し、TikTokは会社ドメインでの審査を2回通す必要がある一方、通ってしまえば無期限トークンで淡々と回り続けます。
判断はシンプルです。会社ドメインのメールと自社サイトが用意できるなら、迷わずAPI直連携で行くのが総コスト最小。逆に、フリーメールしかない・自社サイトが未整備、あるいはTikTokだけで月10万円未満の小規模運用なら、最初からやり方1のスケジュールレポートか、やり方2のツールに寄せて審査時間を買うのが早い。外注する場合の費用相場は広告レポート自動化の費用は？ツール・代行の料金相場と選び方にまとめています。
私たちのアドヨミAIは、Google・Yahoo!・Meta・TikTokなどの広告データをAPIで自動連携し、自社所有のBigQueryに集約するサービスです。媒体ごとに違う審査・仕様・型の癖を吸収した状態で、初期5万円・月1.5万円〜/媒体から運用できます。
まずはSandboxアカウントでモックデータのレポートを1本取ってみると、仕様の癖が30分で体感できます。
株式会社EvastのアドヨミAIは、Google・Yahoo!・Meta・TikTokなど主要媒体の広告データをAPIで自動連携し、自社所有のBigQueryに集約する半スクラッチ型の広告レポート自動化・AI分析サービスです。
現状の運用の棚卸しからで構いません。1媒体・最短2週間から始められます。
Amazon広告のレポート自動化は、まず「Amazon Ads API」と出品者業務向けの「SP-API」を混同しないことが出発点です。LWA（Login with Amazon）でのOAuth認証、API利用申請、Profile ID取得の手順から、reporting/reportsへのレポートリクエスト→ステータスのポーリング→ダウンロードという非同期取得の3ステップ、Pythonの実コードまでを、2026年8月時点で確認できる公式情報に沿って整理します。
Google広告の日次レポートは、無料の公式手段だけで自動化できます。Looker Studio・Google Adsスクリプト・BigQuery Data Transfer・Ads API直連携それぞれの設定のやり方、開発者トークン申請とGAQL・Pythonの実コード、そして集めたデータをChatGPTやGeminiにつないで考察・日次サマリまで自動化する方法、リフレッシュトークン失効などの落とし穴を、2026年7月時点の公式情報で整理します。
Meta広告のレポート自動化でつまずくのは、公式コネクタが無いことと、トークンの静かな失効です。この記事はMarketing API直連携を軸に、システムユーザートークンでの無期限運用と、管理画面との数値ずれの直し方までまとめました。
Yahoo!広告はLooker Studioの公式コネクタが無く、Google広告と同じ感覚で自動化しようとすると手が止まる。管理画面のメール配信、API申請不要のYahoo!広告スクリプト、そしてLINEヤフー広告APIの直連携まで、それぞれのやり方と実コード、集めたデータをAIにつなぐところまでを2026年7月時点の公式情報で整理した。