Você não precisa de nenhuma biblioteca especializada para consumir uma API de scraping do Instagram em Python — a biblioteca requests, padrão de mercado, já é suficiente. Este guia mostra o caminho mais direto.
Instalando o necessário
pip install requests
Fazendo sua primeira chamada
import requests
TOKEN = "seu_token_aqui"
BASE_URL = "https://scrapegram.cloud/api/v1"
headers = {
"Authorization": f"Bearer {TOKEN}"
}
resposta = requests.get(
f"{BASE_URL}/instagram/profile",
headers=headers,
params={"username": "nike"}
)
dados = resposta.json()
print(dados["followers"])
Tratando erros corretamente
Uma integração de produção nunca deve assumir que toda resposta vem com sucesso. Trate ao menos estes três casos:
if resposta.status_code == 200:
dados = resposta.json()
elif resposta.status_code == 404:
print("Perfil nao encontrado ou privado")
elif resposta.status_code == 429:
print("Cota excedida -- aguarde antes de tentar de novo")
else:
print(f"Erro inesperado: {resposta.status_code}")
Construindo uma função reutilizável
def buscar_perfil(username: str) -> dict | None:
resp = requests.get(
f"{BASE_URL}/instagram/profile",
headers=headers,
params={"username": username},
timeout=10,
)
if resp.ok:
return resp.json()
return None
perfil = buscar_perfil("nike")
if perfil:
print(f"{perfil['username']} tem {perfil['followers']:,} seguidores")
Consultando vários perfis em lote
Para analisar uma lista de concorrentes de uma vez, basta iterar — sempre respeitando o intervalo recomendado entre chamadas para não estourar o rate limit do seu plano:
import time
concorrentes = ["nike", "adidas", "puma"]
resultados = []
for user in concorrentes:
perfil = buscar_perfil(user)
if perfil:
resultados.append(perfil)
time.sleep(0.5)
for r in resultados:
print(r["username"], r["followers"])
Próximos passos
Esse mesmo padrão funciona para os outros endpoints — posts, seguidores, stories públicas — trocando apenas o caminho da URL e os parâmetros. Toda a lista de endpoints disponíveis, com exemplos prontos para copiar, está na documentação interativa do ScrapeGram, incluindo um testador onde dá pra rodar a chamada direto no navegador antes de colar no seu código.