Ricerca degli hashtag

Trova contenuti multimediali di IG pubblici taggati con hashtag specifici.

Limitazioni

• Puoi interrogare un massimo di 30 hashtag unici per conto di un account business o creator di Instagram in un periodo continuo di 7 giorni. Un hashtag interrogato verrà conteggiato rispetto a questo limite per 7 giorni. Le query successive sullo stesso hashtag in questo lasso di tempo non verranno conteggiate rispetto al tuo limite e non ripristineranno il timer iniziale di 7 giorni della query.
• Non puoi commentare elementi multimediali con hashtag scoperti tramite l'API.
• Gli hashtag nelle storie non sono supportati.
• Le emoji nelle query degli hashtag non sono supportate.
• L'API restituirà un errore generico per tutte le richieste che includono hashtag che abbiamo ritenuto offensivi o inerenti a temi delicati.

Requisiti

Per utilizzare questa API, è necessario eseguire l'analisi dell'app e richiedere l'approvazione per:

• la funzione Instagram Public Content Access
• l'autorizzazione instagram_basic

Endpoint

L'API Hashtag Search è costituita dai seguenti nodi e segmenti:

• GET /ig_hashtag_search: consente di ottenere l'ID del nodo di un hashtag specifico
• GET /{ig-hashtag-id}: consente di ottenere dati su un hashtag
• GET /{ig-hashtag-id}/top_media: consente di ottenere le foto e i video più popolari con un hashtag specifico
• GET /{ig-hashtag-id}/recent_media: consente di ottenere le foto e i video pubblicati più di recente con un hashtag specifico
• GET /{ig-user-id}/recently_searched_hashtags: consente di determinare gli hashtag unici che un account business o creator di Instagram ha cercato nella settimana corrente

Consulta la documentazione di riferimento di ogni endpoint per campi, parametri e requisiti di utilizzo supportati.

Utilizzi comuni

Ottenere contenuti multimediali taggati con un hashtag

Per ottenere tutte le foto e i video con un hashtag specifico, utilizza prima l'endpoint /ig_hashtag_search e includi l'hashtag e l'ID dell'account business o creator di Instagram che esegue la query. Ad esempio, se la query viene eseguita per conto di un account business di Instagram con l'ID 17841405309211844, potresti ottenere l'ID dell'hashtag "#coke" eseguendo questa query:

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

Questo restituirà l'ID per il nodo dell'hashtag "#Coke":

{
  "id" : "17873440459141021"
}

Ora che hai l'ID dell'hashtag (17873440459141021), puoi interrogarne il segmento /top_media o /recent_media e includere l'ID dell'account business per ottenere una raccolta di oggetti multimediali con l'hashtag "#coke". Ad esempio:

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

In questo modo, viene restituita una risposta che si presenta così:

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}