instagram/
tagged-posts

Raccogli i post Instagram pubblici che taggano profili selezionati a partire da uno o più nomi utente, con didascalie, autori, contenuti multimediali, menzioni ed engagement visibile.

Instagram Tagged Posts API

Tag dei profili
Contesto del post
Contenuti pubblici
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
usernamesObbligatorioUno o più nomi utente di profili Instagram pubblici senza @, separati da virgole o a capo.
results_limitFacoltativoNumero 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.

  1. Prepara uno o più nomi utente Instagram pubblici senza il carattere @ iniziale.
  2. Invia con POST usernames e un results_limit facoltativo da 1 a 2.000 a /v1/instagram/tagged-posts.
  3. Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
  4. 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_cursor

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di Instagram con i dati pubblici delle altre piattaforme social supportate.

Instagram Tagged Posts API — FAQ

Instagram Tagged Posts API è un’interfaccia programmatica per recuperare i post pubblici che taggano i profili identificati da uno o più nomi utente inviati. Restituisce identità normalizzata di post e autore, didascalie, contenuti multimediali, contesto degli utenti taggati, menzioni, timestamp ed engagement visibile.

No. Questo endpoint trova i post che taggano il profilo di destinazione; le menzioni sono campi restituiti con i post corrispondenti quando il risultato pubblico le fornisce, non una ricerca separata dei post che le contengono.

Invia un array usernames non vuoto con nomi utente di profili pubblici; la mappatura dell’input rimuove una @ iniziale. results_limit è facoltativo e accetta un numero intero da 1 a 2.000, con valore predefinito 100.

extra.tagged_users conserva il contesto strutturato dei tag dei profili restituito per il post. mentions è un elenco separato di nomi utente restituiti come menzioni nel record di contenuto normalizzato.

Tagged Posts trova i post pubblici che taggano profili selezionati. Instagram Posts invece raccoglie i post pubblicati dai nomi utente inviati.

I record possono includere ID, shortcode, URL, didascalia, identità dell’autore, contenuti multimediali, hashtag, menzioni, utenti taggati, tipo di prodotto, orari di pubblicazione e raccolta e conteggi visibili di Mi piace, commenti, visualizzazioni o riproduzioni.

Possono essere restituiti solo i post corrispondenti disponibili pubblicamente. Record e campi rimossi, con restrizioni, privati, visibili solo dopo l’accesso o omessi dalla fonte possono produrre risultati parziali o vuoti.

Leggi fino a 500 risultati dell’attività per pagina e prosegui con next_cursor finché has_more è true.

I risultati normalizzati riusciti costano 0,5 crediti per record, senza costo base. Un risultato vuoto costa zero crediti secondo la policy di solo costo base.