instagram/
tagged-posts

Öffentliche Instagram-Beiträge, die ausgewählte Profile markieren, zu einem oder mehreren Benutzernamen erfassen – mit Bildunterschriften, Autoren, Medien, Erwähnungen und sichtbarer Interaktion.

Instagram Tagged Posts API

Profilmarkierungen
Beitragskontext
Öffentliche Inhalte
0,5 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 Tagged Posts

Markierte Instagram-Beiträge sind öffentliche Veröffentlichungen, die über Markierungen auf Beitragsebene ein anderes Profil kenntlich machen und erwähnte Benutzernamen enthalten können, dazu Bildunterschriften, Autoren, Medien, Hashtags, Zeitstempel und sichtbare Interaktion. Diese Inhalts- und Beziehungssignale unterstützen die Beobachtung von Markierungen, die Prüfung von Zuordnungen, die Creator-Recherche und strukturierte Inhaltsarchive.

Funktionen der Instagram Tagged Posts API

  • Entdeckung per ProfilmarkierungVerwenden Sie öffentliche Instagram-Benutzernamen als Ziele und erhalten Sie Beiträge, die diese Profile markieren, statt Beiträgen, die das Zielkonto selbst verfasst hat.
  • Identität von Beitrag und AutorSie erhalten Beitrags-IDs, Shortcodes, Beitrags-URLs, Bildunterschriften und normalisierte Profilfelder der Autoren für nachvollziehbare Inhaltsdatensätze.
  • Kontext zu markierten Nutzern und ErwähnungenDer strukturierte Kontext in tagged_users bleibt neben Hashtags und zurückgegebenen Erwähnungen erhalten, sodass sich die verschiedenen Beziehungen eines Beitrags unterscheiden lassen.
  • Medien und sichtbare InteraktionLiefert normalisierte Verweise auf Bilder oder Videos zusammen mit den sichtbaren Zahlen zu Likes, Kommentaren, Aufrufen und Wiedergaben jedes öffentlichen Beitrags.
  • Kontext der VeröffentlichungEnthält normalisierte Veröffentlichungs- und Erfassungszeit sowie den Kontext product_type für die chronologische Prüfung und die Einordnung des Beitragsformats.

Parameter der Instagram Tagged Posts API

ParameterErforderlichBeschreibung
usernamesErforderlichEin oder mehrere öffentliche Instagram-Profilbenutzernamen ohne @, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale Zahl der Datensätze markierter Beiträge, die die Aufgabe anfordert; eine ganze Zahl von 1 bis 2.000, Standardwert 100.

So verwenden Sie die Instagram Tagged Posts API

Senden Sie die Benutzernamen der Zielprofile als asynchrone Aufgabe, fragen Sie die zurückgegebene Aufgaben-ID ab und lesen Sie die normalisierten markierten Beiträge per Cursor-Paginierung aus.

  1. Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen ohne das führende @ vor.
  2. Senden Sie usernames und optional results_limit von 1 bis 2.000 per POST an /v1/instagram/tagged-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 übergeben Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/tagged-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

Anwendungsfälle der Instagram Tagged Posts API

  • Profilmarkierungen beobachten: Nutzen Sie tagged_users, Beitrags-URLs, Bildunterschriften, Autoren und Zeitstempel, um öffentliche Beiträge zu prüfen, die ausgewählte Profile markieren.
  • Zuordnung zu Kampagnen prüfen: Vergleichen Sie Bildunterschriften, Medien, Kontext markierter Nutzer und sichtbare Interaktion über Beiträge hinweg, die mit der Markierung eines Kampagnenprofils zusammenhängen.
  • Recherche zu Creator-Beiträgen: Nutzen Sie die normalisierte Identität der Autoren und die Beziehungen der Profilmarkierungen, um öffentliche Creator zu finden, die Inhalte rund um ausgewählte Konten veröffentlichen.
  • Markierte Inhalte archivieren: Speichern Sie Beitrags-IDs, Shortcodes, zurückgegebene URLs, Medienverweise, Veröffentlichungs- und Erfassungszeiten in prüfbaren Inhaltsdatensätzen.

Profi-Tipps zur Instagram Tagged Posts API

  • Entfernen Sie vor dem Senden das führende @ von jedem Ziel-Benutzernamen, damit die Anfrage eine saubere Profilkennung verwendet.
  • Lesen Sie extra.tagged_users für Profilmarkierungen auf Beitragsebene und mentions für zurückgegebene Erwähnungen und behandeln Sie die beiden Felder nicht als austauschbar.
  • Deduplizieren Sie wiederholte Erfassungen mit einer Beitrags-ID oder einem Shortcode und behalten Sie die zurückgegebene Beitrags-URL für Prüfung und Nachvollziehbarkeit.
  • Rechnen Sie damit, dass Medien, Interaktionszähler, Autorenkennzeichen und Zeitstempel fehlen können, denn normalisierte öffentliche Datensätze behalten nullable Quellfelder bei.
  • Fahren Sie mit results.next_cursor fort, solange results.has_more den Wert true hat, damit größere Ergebnismengen markierter Beiträge nicht nach der ersten Seite abgeschnitten werden.

Ergänzend zur Instagram Tagged Posts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Instagram-Daten benötigen.

  • Instagram Posts API — Öffentliche Beiträge, Medien, Hashtags, Erwähnungen, Zeitstempel und Interaktionen per Benutzername erfassen.
  • 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 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 Tagged Posts API — FAQ

Instagram Tagged Posts API ist eine Schnittstelle, die öffentliche Beiträge abruft, die Profile markieren, welche über einen oder mehrere gesendete Benutzernamen angegeben werden. Sie liefert normalisierte Identität von Beitrag und Autor, Bildunterschriften, Medien, Kontext markierter Nutzer, Erwähnungen, Zeitstempel und sichtbare Interaktion.

Nein. Dieser Endpunkt findet Beiträge, die das Zielprofil markieren; Erwähnungen sind Felder, die zu passenden Beiträgen zurückgegeben werden, wenn das öffentliche Ergebnis sie enthält, und keine eigene Suche nach Beiträgen mit Erwähnungen.

Senden Sie ein nicht leeres Array usernames mit öffentlichen Profilbenutzernamen; die Eingabeverarbeitung entfernt ein führendes @. results_limit ist optional und akzeptiert eine ganze Zahl von 1 bis 2.000, der Standardwert ist 100.

extra.tagged_users bewahrt den strukturierten Kontext der Profilmarkierungen, der zum Beitrag zurückgegeben wird. mentions ist eine eigene Liste von Benutzernamen, die im normalisierten Inhaltsdatensatz als Erwähnungen zurückgegeben werden.

Tagged Posts findet öffentliche Beiträge, die ausgewählte Profile markieren. Instagram Posts erfasst dagegen Beiträge, die von den gesendeten Benutzernamen selbst verfasst wurden.

Datensätze können ID, Shortcode, URL, Bildunterschrift, Identität des Autors, Medien, Hashtags, Erwähnungen, markierte Nutzer, Produkttyp, Veröffentlichungs- und Erfassungszeit sowie die sichtbaren Zahlen zu Likes, Kommentaren, Aufrufen oder Wiedergaben enthalten.

Es können nur öffentlich verfügbare passende Beiträge zurückgegeben werden. Entfernte, eingeschränkte, private, nur nach Anmeldung sichtbare oder von der Quelle ausgelassene Datensätze und Felder können zu teilweisen oder leeren Ergebnissen führen.

Lesen Sie bis zu 500 Aufgabenergebnisse pro Seite und fahren Sie mit next_cursor fort, solange has_more den Wert true hat.

Erfolgreiche normalisierte Ergebnisse kosten 0,5 Credits pro Datensatz, ohne Grundgebühr. Ein leeres Ergebnis kostet nach der reinen Grundregel null Credits.