Documentação — ScrapeGram

Introdução v2

A API do ScrapeGram devolve dados públicos do Instagram em JSON, atraves de uma unica chave de acesso.

Instável agora? Tente a v1:

Essa é a API v2 (fornecedor 2, alternativo). Se ela estiver fora do ar ou respondendo com erro, use a API v1 -- é o fornecedor original, mais endpoints (comentários, curtidas, stories, hashtag etc). O mesmo token que você já usa na v2 funciona direto na v1, não precisa gerar outro nem recadastrar nada.

Base URL:

https://scrapegram.cloud/api/v2

Sem OAuthAutenticação simples via Bearer token

JSONResposta estruturada, pronta pra consumo

PIXPagamento em real, sem cartao internacional

21 endpointsPerfis, publicações, localizações e mais

Autenticação Obrigatório

Toda requisição deve incluir o token gerado no seu painel, no header Authorization.

Header Authorization: Bearer {seu_token} Token gerado em /painel/token

curl https://scrapegram.cloud/api/v2/instagram/analytics?username=instagram \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"

Importante:

Nunca compartilhe seu token publicamente. Se ele vazar, revogue e gere outro no painel.

Cota e limites Por plano

Cada plano tem um limite de requisições por mes, que reseta a cada ciclo de 30 dias. Ao atingir o limite, a API retorna 429 ate voce renovar ou fazer upgrade.

Starter1,000 requisicoes/mes

Pro100,000 requisicoes/mes

Business200,000 requisicoes/mes

Scale400,000 requisicoes/mes

Resposta 429 — cota esgotada

{
  "ok": false,
  "erro": "Cota do plano esgotada para este ciclo."
}

GET /instagram/analytics Exemplo

Analytics do perfil (engajamento medio, etc)

GET /api/v2/instagram/analytics?username={username} Analytics do perfil

GET /instagram/comparar-perfis Exemplo

Comparar dois perfis

GET /api/v2/instagram/comparar-perfis?username_1={username_1}&username_2={username_2} Comparar perfis

GET /instagram/contato-comercial Exemplo

Contato comercial da conta

GET /api/v2/instagram/contato-comercial?username={username} Contato comercial

GET /instagram/destaques-graphql Exemplo

Destaques/highlights (resposta bruta GraphQL)

GET /api/v2/instagram/destaques-graphql?user_id={user_id} Destaques (GraphQL)

GET /instagram/diretorio-localizacoes Exemplo

Diretorio de paises com localizacoes

GET /api/v2/instagram/diretorio-localizacoes?page={page} Diretório de localizações

GET /instagram/feed Exemplo

Feed de publicacoes do usuario

GET /api/v2/instagram/feed?username={username} Feed

GET /instagram/id-do-usuario Exemplo

ID numerico a partir do username

GET /api/v2/instagram/id-do-usuario?username={username} ID do usuário

GET /instagram/id-para-shortcode Exemplo

Converter media_id em shortcode

GET /api/v2/instagram/id-para-shortcode?media_id={media_id} ID → Shortcode

GET /instagram/localizacoes-cidade Exemplo

Localizacoes de uma cidade

GET /api/v2/instagram/localizacoes-cidade?city_code={city_code} Localizações da cidade

GET /instagram/localizacoes-pais Exemplo

Localizacoes/cidades de um pais

GET /api/v2/instagram/localizacoes-pais?country_code={country_code} Localizações do país

GET /instagram/localizacoes-proximas Exemplo

Localizacoes proximas a uma localizacao

GET /api/v2/instagram/localizacoes-proximas?location_id={location_id} Localizações próximas

GET /instagram/midia-hd Exemplo

URLs de midia em HD de uma publicacao

GET /api/v2/instagram/midia-hd?shortcode={shortcode} Mídia em HD

GET /instagram/perfil Exemplo

Dados do perfil (fornecedor 2)

GET /api/v2/instagram/perfil?username={username} Perfil

GET /instagram/perfil-por-id Exemplo

Dados do perfil por ID numerico

GET /api/v2/instagram/perfil-por-id?user_id={user_id} Perfil por ID

GET /instagram/publicacao Exemplo

Dados de uma publicacao (por shortcode)

GET /api/v2/instagram/publicacao?shortcode={shortcode} Publicação por shortcode

GET /instagram/publicacao-por-id Exemplo

Dados de uma publicacao (por media_id)

GET /api/v2/instagram/publicacao-por-id?media_id={media_id} Publicação por ID

GET /instagram/publicacoes Exemplo

Publicacoes do usuario

GET /api/v2/instagram/publicacoes?username={username} Publicações

GET /instagram/reels Exemplo

Reels do usuario

GET /api/v2/instagram/reels?user_id={user_id} Reels

GET /instagram/reels-graphql Exemplo

Reels (resposta bruta GraphQL)

GET /api/v2/instagram/reels-graphql?user_id={user_id} Reels (GraphQL)

GET /instagram/shortcode-para-id Exemplo

Converter shortcode em media_id

GET /api/v2/instagram/shortcode-para-id?shortcode={shortcode} Shortcode → ID

GET /instagram/username-por-id Exemplo

Username a partir do ID numerico

GET /api/v2/instagram/username-por-id?user_id={user_id} Username por ID

Testar API Ao vivo

Cole seu token, escolha um endpoint, preencha os campos e veja a resposta real na hora -- a chamada sai daqui pro seu proprio token, que repassa pro fornecedor por tras.

Seu token de API

Salvo so no seu navegador (nunca enviado pra nenhum outro lugar alem da API).

Endpoint

Todos os endpoints 21

Catalogo completo da API v2. Todos aceitam GET com os parametros na query string, autenticados com o mesmo token da sua conta -- o mesmo token usado aqui funciona igual na API v1.

GET /api/v2/instagram/analytics

Analytics do perfil (engajamento medio, etc)

Parametro	Descricao	Exemplo
`username`	Nome de usuário do Instagram, sem @.	`instagram`