Internal helper

TikTok Developer Portal — champs à copier

BASE URL utilisée : https://trackapp.fr (via NEXT_PUBLIC_APP_URL). Les pages légales EN doivent répondre en 200 sur la prod avant soumission.

Commercial Content API — ce que dit la doc officielle

Résumé de Getting Started + produit Commercial Content API. Trackapp implémente déjà le flux technique (serveur) dans src/lib/tiktok-ad-library.ts — à brancher après approbation TikTok.

Compte développeur : inscription.
Demande d'accès obligatoire : remplis le formulaire officiel developers.tiktok.com/application/commercial-content-api. Réponse sous ~2 jours ouvrés (email possible depuis commercial-research-questions@tiktok.com).
Une fois approuvé : un research client est créé. Va sur developers.tiktok.com/research/, ouvre ton projet → récupère Client key + Client secret (icône œil).
Jeton : obtention via OAuth client_credentials (voir Client Access Token Management). Trackapp le fait automatiquement avec TIKTOK_CLIENT_KEY / TIKTOK_CLIENT_SECRET.
Requête ads : POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ avec header Authorization: Bearer <token>, corps JSON filters.ad_published_date_range, country_code, search_term, pagination search_id. Identique à ton endpoint /api/tiktok/ad-library.

TikTok indique qu'en phase actuelle les données commerciales exposées concernent surtout les pubs ayant touché l'UE ; élargissement géographique annoncé progressivement. Pour les tests API, privilégie un country_code UE (ex. FR, IT) comme dans leurs exemples.

App details — Description (≤120)

Trackapp is a web app for mobile app intelligence: rankings & optional public ad insights via TikTok Research API.

114 caractères

Terms of Service URL

https://trackapp.fr/trackapp/legal/terms

Privacy Policy URL

https://trackapp.fr/trackapp/legal/privacy

Platforms

Coche Web (Trackapp est un site Next.js). Ne coche mobile que si tu distribues une app native qui embarque le même flux.

App review — Product & scope (≤1000)

Trackapp (trackapp.fr): mobile competitive intelligence (web).

Product: TikTok Commercial Content API — Research Ad Library. Scope: research.adlib.basic.

Server: Env holds Client Key/Secret. OAuth client_credentials → Bearer; POST open.tiktokapis.com/v2/research/adlib/ad/query/ with ad_published_date_range, country_code (EU e.g. FR), search_term, max_count; pagination via search_id.

UI: Users sign in via Trackapp (Supabase). Tracker → app → Ads → TikTok: browser hits /api/tiktok/ad-library only; we display returned public ad metadata. No TikTok Login/Share/Display/Content Posting — no TikTok user OAuth in-browser for this.

Compliance: Rate limits + TikTok data rules.

Demo: HTTPS → login → Ads → TikTok end-to-end (sandbox/API message OK). Hide secrets.

Align portal Products with this text; if you add products, update both.

839 caractères

Vidéo démo — exigences TikTok

Formats mp4/mov, max 5 fichiers × 50 Mo. Montre le site HTTPS réel où l’intégration vivra (pas une maquette isolée). Si l’app n’a jamais été approuvée, utilise un environnement sandbox pour la démo.

Script suggéré (≤2–3 min) :

Ouvre trackapp.fr (ou preview Vercel) — barre d’adresse visible.
Connexion compte démo Trackapp (Supabase).
Tracker → choisir une app → onglet Ads → panneau TikTok : chargement puis résultats ou message clair (sandbox / API).
Optionnel : DevTools → Network filtré pour montrer uniquement des appels vers ton domaine (/api/tiktok/ad-library), sans jetons ni secrets.

Ne filme jamais Client Secret, .env ou jetons Bearer. Si le portail TikTok liste des produits que tu n’implémentes pas (ex. Login Kit), décoche-les ou refais la vidéo pour les montrer — sinon le texte ci-dessus et la vidéo ne correspondront pas.

Fichier refusé (> 50 Mo) ?

Dans le repo Trackapp, avec ffmpeg (brew install ffmpeg) :

npm run tiktok:compress-demo -- /chemin/vers/trackapp.mov

Sortie par défaut : trackapp_tiktok_under50mb.mp4 dans le même dossier que la source. Ré-upload ce .mp4 sur TikTok.

Pages légales : Terms · Privacy