Instagram fetcher.sh

Twitter/X, YouTube, Reddit, Google y más: más de 100 endpoints en total. Sin cuenta, sin OAuth, sin suscripción. Paga por llamada en USDC, o recarga una vez y gasta un saldo en todos ellos.

GitHub
2

Documentación

name: instagram-api description: >- Una alternativa a la API de Instagram en fetcher.sh — pago por llamada en USDC vía x402, o créditos prepagados con una clave Bearer, sin inicio de sesión ni cookies de sesión. Úsalo cuando el usuario quiera resolver un perfil de Instagram por @handle, buscar usuarios por palabra clave, obtener los posts, reels, stories, posts etiquetados, seguidores o seguidos de un perfil, consultar un post individual por su shortcode, leer los comentarios de un post, obtener posts bajo un hashtag o un feed de reels por hashtag, obtener posts de una ubicación, u obtener posts usando una pista de audio/música específica. También cubre la exportación de seguidores de Instagram, monitoreo de hashtags y ubicaciones, descubrimiento de influencers, seguimiento de contenido de competidores y pipelines de datos de Instagram sin verificación oficial de negocio de Graph API ni navegador headless. keywords:

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

API de Instagram

Datos de Instagram bajo demanda: búsqueda de perfil por @handle, posts, reels, stories, posts etiquetados, seguidores y seguidos, feeds de hashtags y ubicaciones, feeds de audio/música y comentarios de posts — un simple HTTP GET por llamada, pago por uso. Sin inicio de sesión, sin cookies de sesión, sin navegador headless, sin verificación de negocio de Graph API.

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

Referencia rápida

URL basehttps://instagram.fetcher.sh
AutenticaciónAuthorization: Bearer bby_live_... o x402 (USDC)
Precio$0.004/llamada (tarifa plana)
Endpoints16, todos GET
MCPhttps://instagram.fetcher.sh/mcp
Legible por máquina/openapi.json · /llms.txt · /skill.md

¿Qué endpoint necesito?

Quiero...Llamar
Buscar un perfil por @handleGET /api/user/handle/{handle}
Buscar cuentas por nombreGET /api/user/search
Obtener los posts, reels o stories de un usuarioGET /api/user/{id}/posts / /reels / /stories
Obtener los seguidores o seguidos de un usuarioGET /api/user/{id}/followers / /followings
Buscar un post por su shortcode de URL compartidaGET /api/post/code/{code}
Obtener los comentarios de un postGET /api/post/{id}/comments
Encontrar posts bajo un hashtagGET /api/hashtag/{name}/posts
Encontrar posts etiquetados en una ubicaciónGET /api/location/{id}/posts

Detalles completos de parámetros para cada fila: references/endpoints.md.

Autenticación

Dos formas de pagar, mismos datos — mecánica completa en la habilidad 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.

Cada respuesta es { "status": number, "message": string, "data": ... }; el estado HTTP refleja status.

Endpoints (16 — todos GET, $0.004/llamada)

EndpointQué devuelve
/api/user/handle/{handle}Perfil completo por @handle — conteos de seguidores, biografía, ID numérico
/api/user/searchPerfiles que coinciden con una consulta de palabra clave
/api/userid/{handle}Solo el ID numérico de usuario para un @handle
/api/user/{id}Perfil por ID numérico
/api/user/{id}/postsLos posts de un usuario
/api/user/{id}/posts/taggedPosts en los que el usuario está etiquetado
/api/user/{id}/reelsLos reels de un usuario
/api/user/{id}/storiesLas stories activas de un usuario
/api/user/{id}/followersLos seguidores de un usuario
/api/user/{id}/followingsCuentas que sigue un usuario
/api/post/code/{code}Un post individual por su shortcode (de la URL del post)
/api/post/{id}/commentsLos comentarios de un post
/api/hashtag/{name}/postsPosts bajo un hashtag
/api/hashtag/{name}/reelsReels bajo un hashtag
/api/location/{id}/postsPosts etiquetados en una ubicación
/api/audio/{id}/postsPosts que usan una pista de audio/música específica

{id} / {handle} / {name} / {code} son parámetros de ruta. Los opcionales cursor / page paginan; query (búsqueda de usuarios) es obligatorio donde aparece.

Escenarios

Resolver un perfil por handle — el endpoint que la mayoría de los llamadores quiere primero:

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 perfiles por palabra clave, o resolver solo el ID numérico para un 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"

Los posts, reels, stories y posts etiquetados de un perfil (por ID numérico de la búsqueda de handle anterior):

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 y 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"

Un post individual por shortcode (la parte de la URL después de /p/), y sus comentarios:

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 y reels bajo un hashtag, posts de una ubicación y posts que usan una pista de audio:

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_..." }
    }
  }
}

Gratis: search_endpoints, describe_endpoint, check_balance. De pago: fetch_data (cualquier endpoint anterior), topup_credits, más el atajo nombrado instagram_user_handle. Elimina el bloque headers para pagar por llamada con x402 en su lugar — consulta la habilidad fetcher para el flujo completo.

Errores

  • 400 — parámetro faltante o inválido (el mensaje lo nombra)
  • 401 — clave desconocida o rotada
  • 402 — pago requerido (desafío x402) o topup_required (créditos agotados)
  • 404 — no es una ruta con precio
  • Sin límites de tasa; sin reembolsos por fallos ascendentes (el pago precede a la entrega)

Referencia