Instagram Tagged Posts
I post con tag di Instagram sono pubblicazioni pubbliche che identificano un altro profilo tramite tag a livello di post e possono includere nomi utente menzionati, con didascalie, autori, contenuti multimediali, hashtag, timestamp ed engagement visibile. Questi segnali di contenuto e di relazione supportano il monitoraggio dei tag, la verifica delle attribuzioni, la ricerca sui creator e gli archivi strutturati di contenuti.
Funzionalità della Instagram Tagged Posts API
- Scoperta tramite i tag dei profiliUsa nomi utente Instagram pubblici come bersaglio e ottieni i post che taggano quei profili, non i post pubblicati dall’account di destinazione.
- Identità di post e autoreRicevi ID dei post, shortcode, URL dei post, didascalie e campi normalizzati del profilo dell’autore per record di contenuti tracciabili.
- Contesto di utenti taggati e menzioniMantiene il contesto strutturato di tagged_users accanto a hashtag e menzioni restituite, così le diverse relazioni del post restano distinguibili.
- Contenuti multimediali ed engagement visibileRestituisce riferimenti normalizzati a immagini o video, con i conteggi visibili di Mi piace, commenti, visualizzazioni e riproduzioni forniti per ogni post pubblico.
- Contesto di pubblicazioneInclude orario di pubblicazione normalizzato, orario di raccolta e contesto di product_type per la revisione cronologica e la classificazione del formato dei post.
Parametri della Instagram Tagged Posts API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Uno o più nomi utente di profili Instagram pubblici senza @, separati da virgole o a capo. |
results_limit | Facoltativo | Numero massimo di record di post con tag richiesti dall’attività; un numero intero da 1 a 2.000, con valore predefinito 100. |
Come usare la Instagram Tagged Posts API
Invia i nomi utente dei profili di destinazione come attività asincrona, interroga l’ID attività restituito e leggi i post con tag normalizzati con la paginazione a cursore.
- Prepara uno o più nomi utente Instagram pubblici senza il carattere @ iniziale.
- Invia con POST usernames e un results_limit facoltativo da 1 a 2.000 a /v1/instagram/tagged-posts.
- Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
- Leggi /v1/tasks/{task_id}?limit=50 e passa results.next_cursor finché results.has_more è true.
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_cursorCasi d’uso della Instagram Tagged Posts API
- Monitoraggio dei tag di un profilo: Usa tagged_users, URL dei post, didascalie, autori e timestamp per esaminare i post pubblici che taggano profili selezionati.
- Verifica dell’associazione alle campagne: Confronta didascalie, contenuti multimediali, contesto degli utenti taggati ed engagement visibile sui post collegati al tag di un profilo di campagna.
- Ricerca sui contributi dei creator: Usa l’identità normalizzata degli autori e le relazioni di tag tra profili per individuare i creator pubblici che pubblicano contenuti legati ad account selezionati.
- Archiviazione dei contenuti con tag: Salva ID dei post, shortcode, URL restituiti, riferimenti ai contenuti multimediali, orari di pubblicazione e orari di raccolta in record di contenuti consultabili.
Consigli degli esperti per la Instagram Tagged Posts API
- Rimuovi la @ iniziale da ogni nome utente di destinazione prima dell’invio, così la richiesta usa un identificatore del profilo pulito.
- Leggi extra.tagged_users per i tag dei profili a livello di post e mentions per le stringhe di menzione restituite, invece di considerare i due campi intercambiabili.
- Deduplica le raccolte ripetute con l’ID del post o lo shortcode, poi conserva l’URL del post restituito per verifica e tracciabilità.
- Metti in conto che contenuti multimediali, contatori di engagement, flag dell’autore e timestamp possano mancare, perché i record pubblici normalizzati conservano i campi di origine che possono essere nulli.
- Prosegui con results.next_cursor ogni volta che results.has_more è true, così gli insiemi di risultati più ampi non vengono troncati dopo la prima pagina.
API correlate
Oltre alla Instagram Tagged Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di Instagram.
- Instagram Posts API — Raccoglie post pubblici, media, hashtag, menzioni, date ed engagement a partire dal nome utente.
- Instagram Reels API — Raccoglie Reels pubblici, media, audio, hashtag, menzioni ed engagement a partire dal nome utente.
- Instagram Comments API — Raccoglie commenti pubblici, autori, date, Mi piace e risposte dagli URL dei post.
- Instagram Profiles API — Recupera identità del profilo pubblico, bio, link, flag dell’account, categorie e conteggi visibili a partire dal nome utente.
- Instagram Transcript API — Estrae testo della trascrizione, lingua, formato, URL della fonte e shortcode dagli URL pubblici di post o Reels.
- Instagram Post Info API — Consulta URL pubblici noti di post, Reel o IGTV storici con didascalie, identità dell’autore, media, date, engagement visibile e contesto dell’input.
- 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