Documentação

Referência da API

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

Introdução v1

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

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

22 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=exemplo \
  -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 públicos de um perfil do Instagram.

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

GET /instagram/publicacoes Exemplo

Lista os posts públicos recentes de um perfil.

GET /api/v1/instagram/publicacoes?username_or_url={usuario} Ultimos posts

GET /instagram/hashtag Exemplo

Posts recentes e populares de uma hashtag.

GET /api/v1/instagram/hashtag?hashtag={tag} Dados da hashtag

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 22

Catalogo completo. Todos aceitam GET com os parametros na query string, autenticados com o mesmo token.

GET /api/v1/instagram/busca

Busca de usuarios e hashtags

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`post_id`	Vem do campo "pk" ou "id" na resposta de /instagram/comentarios ou /instagram/midia (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

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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)

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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/midia

Dados de uma publicacao

Parametro	Descricao	Exemplo
`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/midia-id

Converter codigo <-> ID da midia

Parametro	Descricao	Exemplo
`media_code`	Converte o código (o que aparece na URL) no ID numérico interno da publicação, usado por outros endpoints.	`Da5mJC9gnWD`

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/midia-v2

Dados de uma publicacao (v2, com play_count)

Parametro	Descricao	Exemplo
`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/perfil

Dados do perfil

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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)

Parametro	Descricao	Exemplo
`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/publicacoes

Publicacoes do usuario

Parametro	Descricao	Exemplo
`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/reel-titulo

Titulo/descricao de um reel

Parametro	Descricao	Exemplo
`reel_post_code_or_url`	O código do reel (da URL) ou o link completo dele.	`Da5mJC9gnWD`
`type`	Sempre "reel" pra esse endpoint.	`reel`

1 requisicao(oes) do seu plano por chamada

GET /api/v1/instagram/reels

Reels do usuario

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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)

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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

Parametro	Descricao	Exemplo
`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