instagram/
posts

Öffentliche Instagram-Beiträge zu einem oder mehreren Benutzernamen erfassen – mit normalisierten Bildunterschriften, Autorendetails, Medien, Hashtags, Erwähnungen, Zeitstempeln und sichtbarer Interaktion.

Instagram Posts API

Beiträge
Medien-Metadaten
Öffentliche Daten
0,34 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
usernamesErforderlichÖffentliche Instagram-Benutzernamen ohne @, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale 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.

  1. Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen ohne @ vor.
  2. Senden Sie usernames und optional ein results_limit per POST an /v1/instagram/posts.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. 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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Instagram-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Instagram Posts API — FAQ

Instagram Posts API erfasst öffentlich zugängliche Beiträge zu einem oder mehreren Instagram-Benutzernamen. Sie liefert normalisierte Bildunterschriften, Autorendetails, Medienverweise, Hashtags, Erwähnungen, Zeitstempel und sichtbare Interaktionszahlen.

Der aktuelle Endpunkt akzeptiert einen oder mehrere öffentliche Benutzernamen. Eine einzelne Beitrags-URL oder ein Shortcode wird nicht als Anfrageeingabe akzeptiert.

Ja. Wenn öffentliche Ergebnisse Mediendaten enthalten, können normalisierte Einträge Bild- oder Video-URLs, Vorschaubilder, Abmessungen und die Videodauer enthalten.

Übliche Felder sind Beitrags-ID, Shortcode, kanonische URL, Autor, Bildunterschrift, Veröffentlichungszeit, sichtbare Kennzahlen, Medienverweise, Hashtags, Erwähnungen und Erfassungszeit.

Nein. Private, entfernte, eingeschränkte oder nur nach Anmeldung sichtbare Beiträge liefern möglicherweise nur begrenzte Daten oder keinen Datensatz, weil der Endpunkt nur öffentlich zugängliche Ergebnisse erfasst.

Sie kann öffentliche Medienverweise zurückgeben, wenn sie in öffentlichen Ergebnissen enthalten sind. Clients sollten trotzdem mit fehlenden, ablaufenden oder eingeschränkten Medien-URLs rechnen, denn die Verfügbarkeit kann je nach Beitragstyp und Antwort der Quelle schwanken.

Verwenden Sie zurückhaltende Anfrageraten und kleinere Stapel an Benutzernamen, warten Sie nach 429- oder Challenge-Antworten mit Backoff und versuchen Sie es später erneut, wenn eine öffentliche Quelle vorübergehend nicht verfügbar ist.