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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Ein oder mehrere öffentliche Instagram-Profilbenutzernamen ohne @, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale 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.
- Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen ohne das führende @ vor.
- Senden Sie usernames und optional results_limit von 1 bis 2.000 per POST an /v1/instagram/tagged-posts.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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_cursorAnwendungsfä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.
Verwandte APIs
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.
- 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