API Instagram

L'API Instagram ti consente di cercare profili utente, elencare post, reel e media taggati, leggere storie, ottenere dettagli dei post, leggere commenti e risposte, cercare utenti e hashtag, e navigare il grafico sociale (follower / seguiti). Dodici endpoint, tutti a 2 crediti per richiesta.

Endpoint

Autenticazione

Ogni risposta di successo include i campi di monitoraggio dei crediti: credits_used, credits_remaining e response_time (ms).

Identificazione di un utente

Gli endpoint utente accettano o un username o un user_id numerico. Passare username è l'opzione più semplice; viene risolto automaticamente in un user_id. Per chiamate ripetute, leggi data.user.id dalla risposta del profilo e passalo come user_id per saltare la risoluzione.

Profilo utente

POST https://api.scavio.dev/api/v1/instagram/profile

Ottieni un profilo utente Instagram. Passa o username o user_id.

Corpo della richiesta

Esempio

curl -X POST 'https://api.scavio.dev/api/v1/instagram/profile' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"username": "instagram"}'

Campi della risposta (data.user)

Risposta di esempio

{
  "data": {
    "user": {
      "id": "25025320",
      "username": "instagram",
      "full_name": "Instagram",
      "biography": "Discover what's next on Instagram",
      "is_verified": true,
      "is_private": false,
      "edge_followed_by": { "count": 672000000 },
      "edge_follow": { "count": 250 },
      "edge_owner_to_timeline_media": { "count": 7600 }
    }
  },
  "response_time": 845,
  "credits_used": 2,
  "credits_remaining": 11750
}

Post dell'utente

POST https://api.scavio.dev/api/v1/instagram/user/posts

Elenca i post di un utente (media della timeline). Passa username o user_id.

Corpo della richiesta

Paginazione

Usa data.page_info.end_cursor come cursor nella richiesta successiva. Fermati quando data.page_info.has_next_page è false.

Reel dell'utente (/api/v1/instagram/user/reels) e Post taggati (/api/v1/instagram/user/tagged) accettano gli stessi parametri e paginazione dei post dell'utente, restituendo rispettivamente reel e media taggati.

Storie dell'utente

POST https://api.scavio.dev/api/v1/instagram/user/stories

Ottieni le storie attualmente attive di un utente. Passa username o user_id. Restituisce gli URL dei media di ogni storia, il tipo (immagine/video) e il timestamp.

Dettagli del post

POST https://api.scavio.dev/api/v1/instagram/post

Ottieni i dettagli completi di un singolo post o reel. Passa uno tra url, media_id o shortcode.

Corpo della richiesta

Esempio

curl -X POST 'https://api.scavio.dev/api/v1/instagram/post' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"shortcode": "DUajw4YkorV"}'

Commenti del post

POST https://api.scavio.dev/api/v1/instagram/post/comments

Ottieni i commenti su un post. Passa o un shortcode o un url del post.

Corpo della richiesta

Paginazione

Usa data.next_min_id come cursor successivo. Fermati quando è assente. Ogni commento espone un campo pk; usalo come comment_id per l'endpoint delle risposte.

Risposte ai commenti

POST https://api.scavio.dev/api/v1/instagram/post/comments/replies

Ottieni le risposte a un commento specifico.

Corpo della richiesta

Cerca utenti

POST https://api.scavio.dev/api/v1/instagram/search/users

Cerca utenti Instagram per parola chiave.

Corpo della richiesta

Cerca hashtag (/api/v1/instagram/search/hashtags) accetta gli stessi parametri e restituisce gli hashtag corrispondenti con il conteggio dei media.

Follower dell'utente

POST https://api.scavio.dev/api/v1/instagram/user/followers

Ottieni la lista dei follower di un utente. Passa username o user_id.

Corpo della richiesta

Seguiti dell'utente

POST https://api.scavio.dev/api/v1/instagram/user/followings

Ottieni gli account che un utente segue. Stessa struttura e parametri della richiesta per i follower.

Riferimento paginazione

Note

• Ogni endpoint costa 2 crediti per richiesta.
• Gli endpoint utente accettano un username o un user_id numerico; l'endpoint del post accetta un url, media_id o shortcode.
• Le liste di follower e seguiti sono paginabili solo per gli account per cui Instagram lo consente. Account grandi o verificati restituiscono should_limit_list_of_followers: true, has_more: false e nessun next_max_id -- questa è una restrizione di Instagram, non un errore. Testa la paginazione con un account più piccolo e non verificato.
• Consulta Errori per la gestione di 401, 429, e 502.