Data connections
Secrets are never shown. Fixture data is never labeled live.
YouTube
NOT CONNECTED
- Google account + Cloud project
- Enable YouTube Data API v3
- Create an API key → put in
.envas YOUTUBE_API_KEY - Verify: npm run trends:youtube or the test button below
- Cost: API quota (often 10k units/day default — confirm in Cloud Console). Search is ~100 units.
Official API. Preferred organic discovery source for this engine.
Test: open /api/setup/youtube (returns connected true/false only).
| Source | Reality | Commercial |
|---|---|---|
| YouTube Data API v3 | ADAPTER_READY | yes_with_google_terms |
| TikTok Research API | BLOCKED_EXTERNAL | no_for_creators_advertisers_commercial_users_per_current_policy_claim |
| TikTok Display API | BLOCKED_EXTERNAL | authorized_user_data_only |
| TikTok Creative Center (US / Apparel) | IMPORT | public_trend_surface_not_an_undocumented_api |
| TikTok Content Posting API | BLOCKED_EXTERNAL | audit_approval_for_direct_post |
| Instagram / Meta Graph | BLOCKED_EXTERNAL | app_review |
| CSV/JSON bulk import | IMPORT | depends_on_data_license |
| Public URL paste | IMPORT | metadata_only_via_supported_mechanisms |
| Creator-authorized analytics | ADAPTER_READY | with_creator_consent |
| Local fixtures | FIXTURE | demo_only |