Hashtag de Instagram (IG)

Representa un hashtag de Instagram.

Limitaciones

  • Disponible únicamente con el inicio de sesión con Facebook para empresas

Creación

No se admite esta operación.

Lectura

GET /<IG_HASHTAG_ID>

Devuelve campos y perímetros de un hashtag de Instagram.

Limitaciones

Puedes consultar un máximo de 30 hashtags únicos en un período de 7 días.

Requisitos

TipoDescripción

Funciones

Instagram Public Content Access

Permisos

instagram_basic


Si el token es de un usuario cuyo rol en la página se otorgó a través del administrador comercial, también se requiere uno de los siguientes permisos: ads_management, business_management, o pages_read_engagement.

Tokens

Token de acceso de usuario correspondiente al usuario de la app.

Sintaxis de la solicitud

GET https://graph.facebook.com/<IG_HASHTAG_ID>
  ?fields={fields}
  &access_token={access-token}

Parámetros de la cadena de consulta

Incluye los siguientes parámetros de la cadena de consulta para hacer una solicitud más compleja.

ClaveValor

access_token
Cadena (obligatoria)

El token de acceso de usuario de Instagram correspondiente al usuario de la app.

fields
Lista separada por comas

Lista separada por comas de los campos y los perímetros que quieres obtener. Si se omite, recibirás los campos predeterminados.

Campos

Puedes usar el parámetro de la cadena de consulta fields para solicitar los siguientes campos en un hashtag de Instagram.

Nombre del campoDescripción

id

Identificador del hashtag (incluido de forma predeterminada). Los identificadores son estáticos y globales.

name

Nombre del hashtag, sin el símbolo de número inicial.

Perímetros

Puedes solicitar los siguientes perímetros como parámetros de ruta o mediante el parámetro de la cadena de consulta fields.

PerímetroDescripción

recent_media

Obtén una lista con los objetos multimedia de IG de fotos y videos publicados más recientemente con un hashtag específico.

top_media

Encuentra los contenidos multimedia de IG de fotografía y video más populares que se etiqueten con el hashtag.

Respuesta

Objeto con formato JSON que contiene campos predeterminados y solicitados.

{
  "<FIELD_NAME>":"<FIELD_VALUE",
  ...
}

Ejemplo de solicitud

GET https://graph.facebook.com/17841593698074073
  ?fields=id,name
  &access_token=EAADd...

Ejemplo de respuesta

{
  "id": "17841593698074073",
  "name": "coke"
}

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.