API de Búsqueda de hashtags de Instagram

Encuentra los hashtags que da el buscador de Instagram para un keyword como coffee: name, id, post_count, post_count_label y url, por $0.56 por cada 1000 llamadas.

  • Con o sin el signo #
  • Todas las filas en una respuesta, sin página siguiente
  • Las llamadas fallidas y los resultados vacíos no se cobran

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "hashtag_search",
      "params": {
        "keyword": "coffee"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "rank": 1,
          "name": "coffeecoffeecoffee",
          "post_count": 1277620,
          "post_count_label": "1.2M posts"
        },
        …
      ],
      "count": 5
    }
  3. 3Filas

    ranknamepost_countpost_count_label
    1coffeecoffeecoffee12776201.2M posts
    2coffeephotography12116601.2M posts
  4. 4CSV

    instagram-hashtag_search-sample.csv rank,name,id,post_count,post_count_label,url,platform

La solicitud lleva keyword. En la misma respuesta vuelven los hashtags que da el buscador para esa palabra, cada fila con name, post_count y url, que pasan a filas de tabla y a un CSV.

Qué datos obtienes

La tabla muestra filas de una llamada real con la palabra coffee, capturada el 21 de noviembre de 2026, 07:18 (UTC), que devolvió 5 hashtags. Las barras grises marcan datos personales eliminados (••• en el CSV). En tus llamadas recibes estos campos según la tabla de campos.

ranknameidpost_countpost_count_labelurlplatform
1coffeecoffeecoffee12776201.2M postshttps://www.instagram.com/explore/tags/coffeecoffeecoffee/instagram
2coffeephotography12116601.2M postshttps://www.instagram.com/explore/tags/coffeephotography/instagram

Casos de uso

  • Elegir un hashtag

    Lee name y post_count para elegir, entre etiquetas parecidas, la que tiene más publicaciones.

  • Encontrar hashtags cercanos a una palabra

    Escribe una palabra y mira qué hashtags da el buscador de Instagram.

  • Seguir hacia las publicaciones de una etiqueta

    Con el nombre de la etiqueta, usa hashtag para leer las publicaciones que tiene.

  • Comparar el tamaño de los hashtags

    Compara post_count_label para ver el número de publicaciones que la página escribe para cada etiqueta.

Hashtag Search frente a EveryInfra

Comparamos Hashtag Search, la búsqueda oficial, y hashtag_search de EveryInfra en tres puntos: qué devuelven, la revisión de acceso y cuántos hashtags puedes consultar por semana.

AspectoHashtag SearchEveryInfra
Qué devuelveEndpoint GET /ig_hashtag_search: "to get a specific hashtag’s node ID"Una llamada consulta un keyword y devuelve los hashtags que da el buscador para esa palabra, cada fila con name, id y post_count.
Revisión de acceso"In order to use this API, you must undergo App Review and request approval for:" "the Instagram Public Content Access feature"Envías una clave de API de EveryInfra en la cabecera Authorization: Bearer. No presentas ninguna revisión de app de Meta ni inicias sesión en Instagram.
Hashtags que puedes consultar por semana"You can query a maximum of 30 unique hashtags on behalf of an Instagram Business or Creator Account within a rolling, 7 day period."Una llamada consulta un keyword y se cobra por llamada, a $0.000556.

Las citas proceden de la documentación para desarrolladores de Meta, comprobadas el 2026-11-22. Fuentes oficiales: Hashtag Search (actualizada el 2026-11-18)

Límites y detalles a tener en cuenta

  • keyword es obligatorio: una palabra cada vez, como coffee, con o sin el signo #.
  • El resultado son los hashtags que da el buscador de Instagram para la palabra. Todas las filas vuelven en una respuesta y no hay página siguiente. El número de filas cambia según la palabra.
  • Esta capacidad solo encuentra hashtags y no lee las publicaciones que tienen. Para las publicaciones usa hashtag.
  • post_count es el número de publicaciones del hashtag. post_count_label es ese número tal como lo escribe la página de Instagram, por ejemplo 2.2K posts.
  • Cuando no se encuentra nada, la llamada devuelve un resultado vacío y no se cobra.

Precios

Pagas $0.000556 por llamada, no por fila. No hay paginación: todas las filas llegan en una llamada. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$5.56
100,000$55.56
1,000,000$555.56

El total se calcula con el precio de lista por llamada.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "hashtag_search",
  "params": {
    "keyword": "coffee"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Referencia de API

Aquí tienes los parámetros, campos de respuesta, errores y facturación de hashtag_search; copia la página o ábrela en Markdown para dársela a un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Instagram: Búsqueda de hashtags (instagram/hashtag_search).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en instagram y action en hashtag_search, y los parámetros dentro de params.
- Parámetros obligatorios:
  - keyword: Palabra que buscar, como coffee, una por llamada, con o sin #.
- Devuelve una lista de registros. Campos principales de cada registro: rank (Posición desde 1: el orden de esta fila…), name, id, post_count, post_count_label (El número de publicaciones tal como lo…), url.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "hashtag_search",
  "params": {
    "keyword": "coffee"
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíinstagramIdentificador de la plataforma, valor fijo.
actionbodystringSíhashtag_searchIdentificador de la capacidad, valor fijo.
keywordbody.paramsstringSí-Palabra que buscar, como coffee, una por llamada, con o sin #.

Ejemplo de respuesta

#
Obtenida el 21 de noviembre de 2026, 07:18 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "hashtag_search",  "results": [    {      "rank": 1,      "name": "coffeecoffeecoffee",      "id": "•••",      "post_count": 1277620,      "post_count_label": "1.2M posts",      "url": "https://www.instagram.com/explore/tags/coffeecoffeecoffee/",      "platform": "instagram"    },    {      "rank": 2,      "name": "coffeephotography",      "id": "•••",      "post_count": 1211660,      "post_count_label": "1.2M posts",      "url": "https://www.instagram.com/explore/tags/coffeephotography/",      "platform": "instagram"    }  ],  "count": 5,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
rankPosición desde 1: el orden de esta fila dentro de este resultado. user_search: primero las cuentas que devolvió el cuadro de búsqueda de Instagram (matched_by es search_box), en el orden del cuadro de búsqueda; después los autores de publicaciones encontradas con esta palabra clave, que completan la cantidad (matched_by es post_author); los resultados sin matched_by llevan la posición en que Instagram clasifica la cuenta para esta palabra clave. similar_profiles: el lugar de la cuenta entre las similares, ordenadas por seguidores. likers: el lugar de la cuenta en la lista de «me gusta».
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
post_countTotal de publicaciones. null significa no publicado, no 0.
post_count_labelEl número de publicaciones tal como lo escribe Instagram, como 2.2K posts.
urlEnlace al registro en la plataforma.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Preguntas frecuentes

¿Qué devuelve la API de búsqueda de hashtags de Instagram?

Cada fila es un hashtag: name, id, post_count, post_count_label y url, más rank.

¿Cómo leo las publicaciones de un hashtag?

hashtag_search solo encuentra hashtags. Con el nombre de la etiqueta, usa hashtag para leer las publicaciones que tiene.

¿Escribo el signo # en keyword?

No. Funciona con o sin el signo #, una palabra cada vez.

¿Cuánto cuesta una búsqueda?

Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas, por llamada y no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Necesito iniciar sesión en Instagram?

No. Envías una clave de API de EveryInfra en la cabecera Authorization: Bearer y la solicitud lleva solo keyword. No hace falta iniciar sesión en Instagram ni un token de acceso.

Con la misma clave puedes llamar a otras capacidades de Instagram, como hashtag para leer las publicaciones de un hashtag.

Google Analytics solo si aceptas. Privacidad