Instagram fetcher.sh

Twitter/X, YouTube, Reddit, Google e mais - 100+ endpoints no total. Sem conta, sem OAuth, sem assinatura. Pague por chamada em USDC, ou faça um depósito único e use o mesmo saldo em todos eles.

GitHub
2

Documentação

name: instagram-api description: >- Uma alternativa à API do Instagram no fetcher.sh — pagamento por chamada em USDC via x402, ou créditos pré-pagos com chave Bearer, sem login e sem cookies de sessão. Use quando o usuário quiser resolver um perfil do Instagram por @handle, buscar usuários por palavra-chave, puxar posts, reels, stories, posts marcados, seguidores ou seguidos de um perfil, consultar um post individual pelo seu shortcode, ler os comentários de um post, buscar posts sob uma hashtag ou feed de reels por hashtag, puxar posts de uma localização, ou puxar posts usando uma faixa de áudio/música específica. Também cobre exportação de seguidores do Instagram, monitoramento de hashtags e localizações, descoberta de influenciadores, rastreamento de conteúdo de concorrentes e pipelines de dados do Instagram sem verificação oficial de negócios da Graph API ou navegador headless. keywords:

  • instagram
  • instagram-api
  • instagram-api-alternative
  • ig-api
  • social-media
  • social-listening
  • hashtag-tracking
  • x402
  • ai-agent

API do Instagram

Dados do Instagram sob demanda: consulta de perfil por @handle, posts, reels, stories, posts marcados, seguidores e seguidos, feeds de hashtag e localização, feeds de áudio/música e comentários de posts — um simples HTTP GET por chamada, pagamento conforme o uso. Sem login, sem cookies de sessão, sem navegador headless, sem verificação de negócios da Graph API.

URL base: https://instagram.fetcher.sh

Referência rápida

URL basehttps://instagram.fetcher.sh
AutenticaçãoAuthorization: Bearer bby_live_... ou x402 (USDC)
Preço$0,004/chamada (fixo)
Endpoints16, todos GET
MCPhttps://instagram.fetcher.sh/mcp
Legível por máquina/openapi.json · /llms.txt · /skill.md

Qual endpoint eu preciso?

Eu quero...Chamada
Consultar um perfil por @handleGET /api/user/handle/{handle}
Buscar contas por nomeGET /api/user/search
Obter posts, reels ou stories de um usuárioGET /api/user/{id}/posts / /reels / /stories
Obter seguidores ou seguidos de um usuárioGET /api/user/{id}/followers / /followings
Consultar um post pelo shortcode da URL de compartilhamentoGET /api/post/code/{code}
Obter os comentários de um postGET /api/post/{id}/comments
Encontrar posts sob uma hashtagGET /api/hashtag/{name}/posts
Encontrar posts marcados em uma localizaçãoGET /api/location/{id}/posts

Detalhes completos dos parâmetros para cada linha: references/endpoints.md.

Autenticação

Duas formas de pagar, mesmos dados — mecânica completa na habilidade fetcher :

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/handle/nasa"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

Toda resposta é { "status": number, "message": string, "data": ... }; o status HTTP reflete status.

Endpoints (16 — todos GET, $0,004/chamada)

EndpointO que retorna
/api/user/handle/{handle}Perfil completo por @handle — contagens de seguidores, bio, ID numérico
/api/user/searchPerfis correspondentes a uma consulta por palavra-chave
/api/userid/{handle}Apenas o ID numérico do usuário para um @handle
/api/user/{id}Perfil por ID numérico
/api/user/{id}/postsPosts de um usuário
/api/user/{id}/posts/taggedPosts em que o usuário está marcado
/api/user/{id}/reelsReels de um usuário
/api/user/{id}/storiesStories ativos de um usuário
/api/user/{id}/followersSeguidores de um usuário
/api/user/{id}/followingsContas que um usuário segue
/api/post/code/{code}Um post individual pelo seu shortcode (da URL do post)
/api/post/{id}/commentsComentários de um post
/api/hashtag/{name}/postsPosts sob uma hashtag
/api/hashtag/{name}/reelsReels sob uma hashtag
/api/location/{id}/postsPosts marcados em uma localização
/api/audio/{id}/postsPosts usando uma faixa de áudio/música específica

{id} / {handle} / {name} / {code} são parâmetros de caminho. Os opcionais cursor / page paginam; query (busca de usuário) é obrigatório onde aparece.

Cenários

Resolver um perfil por handle — o endpoint que a maioria dos chamadores quer primeiro:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/handle/nasa"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/handle/natgeo"

Buscar perfis por palavra-chave, ou resolver apenas o ID numérico para um handle:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=fitness influencer" -G \
  "https://instagram.fetcher.sh/api/user/search"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/userid/nasa"

Posts, reels, stories e posts marcados de um perfil (por ID numérico da consulta de handle acima):

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/528817151/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/528817151/reels"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/528817151/stories"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/528817151/posts/tagged"

Seguidores e seguidos:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/528817151/followers"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/user/528817151/followings"

Um post individual por shortcode (a parte da URL após /p/) e seus comentários:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/post/code/C0JD3tntcmy"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/post/3245142029192513970/comments"

Posts e reels sob uma hashtag, posts de uma localização e posts usando uma faixa de áudio:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/hashtag/travel/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/hashtag/travel/reels"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/location/213131048/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://instagram.fetcher.sh/api/audio/271328201351336/posts"

MCP

{
  "mcpServers": {
    "instagram": {
      "url": "https://instagram.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

Grátis: search_endpoints, describe_endpoint, check_balance. Pagos: fetch_data (qualquer endpoint acima), topup_credits, além do atalho nomeado instagram_user_handle. Remova o bloco headers para pagar por chamada com x402 em vez disso — veja a habilidade fetcher para o fluxo completo.

Erros

  • 400 — parâmetro ausente/inválido (a mensagem o nomeia)
  • 401 — chave desconhecida ou rotacionada
  • 402 — pagamento necessário (desafio x402) ou topup_required (créditos esgotados)
  • 404 — não é um caminho com preço
  • Sem limites de taxa; sem reembolsos em falhas upstream (a liquidação precede a entrega)

Referência