TESTSYSTEM · Externe APIs sind deaktiviert — keine Live-Daten, keine Aufladungen, keine Mails an Kunden.

Instagram Graph API – Setup & Discovery

Verbindungs-Status

Apify: ✓ Token gespeichert — Hashtag-Discovery aktiv.

Credentials

Aus dem Meta-App-Dashboard, Reiter „App-Einstellungen“.
Numerische ID des mit deiner Facebook-Page verknüpften Instagram-Business-Accounts.
Aus dem Graph API Explorer oder via OAuth-Flow erzeugt. Token läuft nach 60 Tagen ab und muss erneuert werden.
Wenn gesetzt, läuft die Hashtag-Discovery über den Apify Instagram-Scraper statt über die Meta Graph API. Vorteile: keine 24h/30-Hashtag-Limits, kein App-Review, liefert Owner-Handle pro Post. Token aus console.apify.com/account/integrations.

Discovery starten

Triggert einen Lauf über alle Seed-Handles und Hashtags aus den Marktplatz-Einstellungen.

  • Aktuell konfiguriert: 1 Seed-Handles, 1 Hashtags
  • Letzter Lauf: 27.05.2026 15:00 (ok) — +126 neu, ~582 aktualisiert

Setup-Schritte

1. Meta-Developer-Konto + App
Auf developers.facebook.com/apps eine neue App erstellen, Typ „Business“. Produkt „Instagram Graph API“ hinzufügen.
2. Facebook-Page + IG-Business-Account verknüpfen
Eine Facebook-Page mit Instagram-Business- oder Creator-Account verbinden. Die App muss Zugriff auf diese Page erhalten.
3. Long-Lived Page Access Token generieren
Im Graph API Explorer einen User-Access-Token mit folgenden Permissions holen: instagram_basic, pages_show_list, pages_read_engagement, business_management.
Dann via /me/accounts den Page Access Token, dann via /oauth/access_token?grant_type=fb_exchange_token den Long-Lived Token (60 Tage).
4. IG-Business-User-ID herausfinden
GET /me/accounts?fields=instagram_business_account{id,username} — liefert die numerische ID des verknüpften IG-Business-Accounts.
5. App-Review für Production beantragen
Für oEmbed (Embed-HTML fremder Posts) und ggf. erweiterte Hashtag-Reichweite ist der Meta App Review nötig. Im Development-Mode funktionieren alle Calls bereits, aber nur für eingeladene Test-User.
6. Seed-Handles + Hashtags konfigurieren
In den Marktplatz-Einstellungen die Bloomest-Operator-IG-Handles eintragen, deren Posts gecrawlt werden sollen.
7. Discovery testen
Verbindung testen → Discovery jetzt ausführen → Ergebnisse im Posts-Tab prüfen.

Detaillierte Anleitung: docs/instagram_setup_guide.md

Limits & Hinweise

  • Hashtag-Search: maximal 30 unterschiedliche Hashtags pro 7 Tage je IG-Business-Account.
  • business_discovery funktioniert nur für öffentliche Business- oder Creator-Accounts (nicht für Personal-Accounts).
  • oEmbed-HTML wird einmalig pro Post gecacht — kein zusätzlicher API-Call beim Anzeigen.
  • Long-Lived Tokens laufen nach 60 Tagen ab. Erneuerung manuell über den Graph API Explorer (oder per Refresh-Endpoint).