Creación

No se admite esta operación.

Lectura

GET /{ig-user-id}

Obtén campos y perímetros en una cuenta de Instagram para creadores o de Instagram para empresas.

Requisitos

TipoDescripción

Tokens de acceso

Usuario.

Roles comerciales

Si solicitas el campo shopping_product_tag_eligibility para etiquetado de productos, el usuario de la app debe tener un rol de administrador en el administrador comercial que posea la tienda de Instagram.

Tienda de Instagram

Si solicitas el campo shopping_product_tag_eligibility para etiquetado de productos, el usuario de IG debe tener una tienda de Instagram aprobada con un catálogo de productos que contenga productos.

Permisos

instagram_basic
pages_read_engagement
pages_show_list


Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página, también necesitarás alguno de los siguientes elementos:


ads_management
business_management


Si solicitas el campo shopping_product_tag_eligibility para etiquetado de productos, también necesitarás lo siguiente:


catalog_management
instagram_shopping_tag_products

Sintaxis de la solicitud

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={fields}
  &access_token={access-token}

Parámetros de ruta

Marcador de posiciónValor

{api-version}

Versión de la API.

{ig-user-id}

Obligatorio. Identificador del usuario de IG.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

{access-token}

Obligatorio. Token de acceso del usuario de la app.

fields

{fields}

Lista separada por comas de los campos de usuario de Instagram que deseas que se devuelvan en el conjunto de resultados en relación con cada usuario de Instagram.

Campos

Un perímetro puede devolver los campos públicos mediante la expansión de campos.

Nombre del campoDescripción

biography
Público

Texto de la presentación de perfil.

id
Público

Identificador de usuario específico de la app.

ig_id

Identificador del usuario de Instagram. Se usaba con la API de Instagram heredada, ahora obsoleta. En su lugar, usa id.

followers_count
Público

Cantidad total de usuarios de Instagram que siguen al usuario.

follows_count

Cantidad total de usuarios de Instagram que el usuario sigue.

media_count
Público

Cantidad total de contenido multimedia de Instagram publicado sobre el usuario.

name

Nombre de perfil.

profile_picture_url

URL de la foto de perfil.

shopping_product_tag_eligibility

Devuelve true si el usuario de la aplicación configuró una tienda de Instagram y, por lo tanto, es apto para etiquetar productos, de lo contrario devuelve false.

username
Público

Nombre de usuario del perfil.

website
Público

URL del sitio web de perfil único.

Perímetros

PerímetroDescripción

business_discovery

Obtiene datos sobre otros usuarios de IG de Instagram para empresas o creador.

content_publishing_limit

Representa el uso actual de la publicación de contenido de un usuario de IG.

insights

Representa la métrica de la interacción social sobre un usuario de IG.

live_media

Representa una colección de contenido multimedia de Instagram de videos en vivo sobre un usuario de Instagram.

media

Representa una colección de contenido multimedia de IG de un usuario de IG.

media_publish

Publica un contenedor de IG en un usuario de IG de Instagram para empresas.

mentions

Crea un comentario de Instagram sobre un comentario de Instagram o sobre contenido multimedia de IG con texto en el que un usuario de Instagram @mencionó a otro usuario de Instagram.

mentioned_comment

Obtiene datos de un comentario de IG en el que otro usuario de Instagram @mencionó a un usuario de IG en un texto.

mentioned_media

Obtiene datos de un contenido multimedia de IG en el que otro usuario de Instagram @mencionó a un usuario de IG en un texto.

recently_searched_hashtags

Obtiene los hashtags de IG que ha buscado un usuario de IG durante los últimos 7 días.

stories

Representa una colección de objetos multimedia de IG sobre un usuario de IG.

tags

Representa una colección de contenido multimedia de IG en la que a un usuario de IG lo etiquetó otro usuario de Instagram.

Respuesta

Objeto con formato JSON con los campos y perímetros predeterminados y solicitados.

{
  "{field}":"{value}",
  ...
}

Ejemplo de cURL

Solicitud

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Respuesta

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.