Instagram Posts
Instagram-Beiträge sind Feed-Veröffentlichungen mit Bildunterschriften, Autorenkontext, Bildern oder Videos, Zeitstempeln, Hashtags, Erwähnungen und sichtbarer Interaktion. Diese Inhaltssignale unterstützen Creator-Recherche, Kampagnenprüfung, Medienanalyse und historisches Reporting.
Funktionen der Instagram Posts API
- Beitragserfassung per BenutzernameErfassen Sie öffentliche Instagram-Beiträge zu einem oder mehreren Benutzernamen in einer einheitlichen, normalisierten Antwortform.
- Medienverweise und AbmessungenLiefert Verweise auf öffentliche Medien und Vorschaubilder, Abmessungen und die Videodauer in normalisierten Medienfeldern.
- Foto- und VideodatensätzeNormalisiert öffentliche Foto- und Videobeiträge in dieselbe Antwortstruktur.
- Inhalts- und InteraktionsfelderEnthält zu jedem Beitragsdatensatz Text der Bildunterschrift, Autorenidentität, Veröffentlichungszeit, sichtbare Kennzahlen, Hashtags und Erwähnungen.
- Grenze bei öffentlichen DatenPrivate, entfernte, eingeschränkte oder nur nach Anmeldung sichtbare Inhalte bleiben außerhalb der Antwort.
Parameter der Instagram Posts API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Öffentliche Instagram-Benutzernamen ohne @, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale Anzahl an Datensätzen, die die Erfassungsaufgabe anfordern soll. Muss eine positive ganze Zahl sein. |
So verwenden Sie die Instagram Posts API
Senden Sie öffentliche Benutzernamen als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Beitragsdatensätze per Cursor-Paginierung aus.
- Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen ohne @ vor.
- Senden Sie usernames und optional ein results_limit per POST an /v1/instagram/posts.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- Lesen Sie /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, wenn weitere Datensätze vorhanden sind.
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["natgeo"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Anwendungsfälle der Instagram Posts API
- Erfassung von Profilbeiträgen: Erfassen Sie öffentliche Beiträge ausgewählter Instagram-Benutzernamen als normalisierte Datensätze mit Medienverweisen und stabilen Kennungen.
- Inhaltsrecherche: Erfassen Sie öffentliche Bildunterschriften, Zeitstempel, Hashtags und sichtbare Interaktionszähler für Beiträge, die Recherche- oder Analytics-Teams prüfen.
- Archiv-Workflows: Speichern Sie Metadaten öffentlicher Beiträge, Medienverweise, Autorenkontext, Quell-URLs und Erfassungszeiten für Prüfwarteschlangen, Reporting-Systeme oder interne Datensätze.
- Qualitätssicherung von Kampagnen: Prüfen Sie die öffentlichen Beiträge, die für Creator- oder Marken-Benutzernamen zurückgegeben werden, bevor Sie ausgewählte Datensätze mit Kampagnendaten verknüpfen.
- Anreicherung von Profilinhalten: Verknüpfen Sie Beitrags-IDs, Autorendetails, Bildunterschriften, Medienverweise und sichtbare Kennzahlen mit bestehenden Profil- oder Kampagnendatensätzen.
Profi-Tipps zur Instagram Posts API
- Senden Sie Benutzernamen ohne das Präfix @ und halten Sie die Stapel klein, solange Sie einen neuen Workflow validieren.
- Rechnen Sie damit, dass einige öffentliche Datensätze je nach Verfügbarkeit in der Quelle Medienverweise, Zähler oder Zeitstempel auslassen.
- Wenden Sie bei 429, Challenge oder vorübergehenden Sperren zurückhaltende Wiederholungen mit Backoff an, statt aggressiv erneut zu versuchen.
- Nutzen Sie die Reels API für die Reel-Erfassung auf Profilebene, die Search API für die Recherche und die Comments API, wenn öffentliche Kommentar-Threads wichtig sind.
- Richten Sie Workflows nicht auf private Konten, Stories, Highlights oder nur nach Anmeldung sichtbare Felder aus.
Verwandte APIs
Ergänzend zur Instagram Posts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Instagram-Daten benötigen.
- Instagram Reels API — Öffentliche Reels, Medien, Audio, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen.
- Instagram Comments API — Öffentliche Kommentare, Autoren, Zeitstempel, Likes und Antworten aus Beitrags-URLs erfassen.
- Instagram Profiles API — Öffentliche Profilidentität, Bios, Links, Kontomerkmale, Kategorien und sichtbare Zahlen per Benutzername abrufen.
- Instagram Tagged Posts API — Öffentliche Beiträge erfassen, in denen ausgewählte Profile markiert sind – mit Autoren, Medien, Erwähnungen, Kontext der markierten Nutzer und Interaktionen.
- Instagram Transcript API — Transkripttext, Sprache, Format, Quell-URLs und Shortcodes aus öffentlichen Beitrags- oder Reel-URLs extrahieren.
- Instagram Post Info API — Bekannte öffentliche Beitrags-, Reel- oder ältere IGTV-URLs nachschlagen – mit Bildunterschriften, Autorenidentität, Medien, Zeitstempeln, sichtbaren Interaktionen und Eingabekontext.
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API