Documentação V1

Referência da API V1

Autenticação, cota e endpoints publicos do ScrapeGram -- fornecedor 1.

Introdução v1

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

Instável agora? Tente a v2:

Essa é a API v1 (fornecedor 1). Se ela estiver fora do ar ou respondendo com erro, use a API v2 -- é um fornecedor totalmente diferente, com boa parte dos mesmos dados (perfil, publicações, reels etc). O mesmo token que você já usa na v1 funciona direto na v2, não precisa gerar outro nem recadastrar nada.

Base URL:

https://scrapegram.cloud/api/v1

Sem OAuthAutenticação simples via Bearer token
JSONResposta estruturada, pronta pra consumo
PIXPagamento em real, sem cartao internacional
19 endpointsPerfis, posts, stories, hashtags 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/v1/instagram/perfil?username_or_url=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/perfil Exemplo

Retorna os dados publicos de um perfil do Instagram.

GET /api/v1/instagram/perfil?username_or_url={usuario} Perfil

GET /instagram/publicacoes Exemplo

Lista os posts publicos recentes de um perfil.

GET /api/v1/instagram/publicacoes?username_or_url={usuario} Posts & Reels

GET /instagram/hashtag Exemplo

Posts recentes e populares de uma hashtag.

GET /api/v1/instagram/hashtag?hashtag={tag} Hashtags

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.

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

Todos os endpoints 19

Catalogo completo da API v1. 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 v2.

GET /api/v1/instagram/busca

Busca de usuarios e hashtags

ParametroDescricaoExemplo
search_query Texto livre -- busca por usuários e hashtags relacionados ao termo. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/comentarios

Comentarios de uma publicacao

ParametroDescricaoExemplo
media_code O trecho que aparece na URL do post, ex: em instagram.com/p/Da5mJC9gnWD/ o código é Da5mJC9gnWD. Da5mJC9gnWD

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/comentarios-respostas

Respostas de um comentario

ParametroDescricaoExemplo
post_id Vem do campo "pk" ou "id" na resposta de /instagram/comentarios ou /instagram/publicacao (não é o código da URL, é o número). 3943350696161736067
comment_id Vem do campo "id" de cada comentário, na resposta de /instagram/comentarios. 17877076164512542

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/contas-similares

Contas similares

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/curtidas

Quem curtiu a publicacao

ParametroDescricaoExemplo
post_code O trecho que aparece na URL do post, ex: em instagram.com/p/Da5mJC9gnWD/ o código é Da5mJC9gnWD. Da5mJC9gnWD

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/destaques

Destaques (highlights)

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/destaques-stories

Stories de um destaque

ParametroDescricaoExemplo
highlight_id Vem do campo "id" na resposta de /instagram/destaques -- copie o valor exatamente como aparece la, incluindo o "highlight:". highlight:18029499352961095

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/hashtag

Posts e reels de uma hashtag

ParametroDescricaoExemplo
hashtag Nome da hashtag, sem o #. Ex: pra #viagem, digite so viagem. viagem

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/marcacoes

Publicacoes em que foi marcado

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/perfil

Dados do perfil

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/perfil-resumo

Perfil resumido + posts

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/perfil-v2

Dados do perfil (v2)

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/publicacao

Dados de uma publicacao (curtidas, comentarios, visualizacoes)

ParametroDescricaoExemplo
url Aceita o link completo do post, reel ou foto do feed, so o código que aparece na URL (ex: Da5mJC9gnWD) ou o ID numérico interno -- tanto faz, o parâmetro pode se chamar url, media_code ou id. Retorna curtidas, comentários, visualizações, legenda e o tipo da publicação (feed, reel, foto ou carrossel) em um único JSON. https://www.instagram.com/p/Da5mJC9gnWD/

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/publicacoes

Publicacoes do usuario

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/reels

Reels do usuario

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/seguidores

Lista de seguidores

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/seguidores-v2

Lista de seguidores (v2, com verificados)

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/sobre

Sobre a conta

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/stories

Stories ativos

ParametroDescricaoExemplo
username_or_url Nome de usuário do Instagram (com ou sem @) ou o link completo do perfil, ex: instagram, @instagram ou https://instagram.com/instagram. instagram

1 requisicao(oes) do seu plano por chamada