Cómo usar la API de Instagram

La API de Data365 para Instagram es una herramienta útil que te permite buscar publicaciones por hashtag o ubicación y filtrar los resultados obtenidos por los parámetros necesarios, incluido el idioma. Usando la API de Instagram, puedes recopilar una gran cantidad de datos de perfiles públicos de Instagram. Además, puedes obtener una gran cantidad de información de las publicaciones. Por eso, la API de Instagram será especialmente útil para las empresas dedicadas a la investigación de mercado y análisis.

Veamos cómo usar la API de Instagram con más detalle. En este artículo, te explicamos cómo funcionan las solicitudes POST y GET y cómo aplicarlas correctamente. También presentamos el parámetro callback_url, con el cual puedes obtener datos directamente en la URL del usuario, y te contamos sobre el formato de nuestras respuestas de API y qué datos puedes obtener. Usando el ejemplo detallado de búsqueda de publicaciones, mostraremos cómo usar la API de Instagram de Data365.co. Y al final, aprenderás qué son los webhooks, para qué sirven y cómo nuestra API de Instagram proporciona esta función.

Solicitud de API de Instagram

La API de Instagram de Data365 se basa en HTTP, un protocolo de capa de aplicación para comunicarse a través de recursos de internet. Por lo tanto, tiene todas las ventajas clave de este tipo de API: almacenamiento en caché, escalabilidad, sobrecarga mínima y códigos de error estándar. Nuestra API de Instagram utiliza métodos de interacción como solicitudes POST y GET.

Solicitud POST es una tarea para actualizar datos, es decir, es una tarea para agregar nuevos datos de Instagram a la base de datos de Data365 o actualizar datos existentes. Se cobra por las solicitudes POST y se cuentan en menciones.

Solicitud GET es una consulta a las bases de datos de Data365 para obtener los datos recopilados después de que se haya completado la consulta POST. Puedes enviar hasta 100 solicitudes GET por segundo. No se te cobrará por las solicitudes GET.

¿Cómo hacer solicitudes a la API de Instagram?

Al crear solicitudes, asegúrate de especificar el ID del elemento para el cual deseas obtener datos o buscar, por ejemplo, ID de publicación de Instagram, ID de perfil, ID de ubicación, hashtag, etc.

En la solicitud POST, puedes especificar parámetros adicionales que pueden aumentar o disminuir la cantidad de datos descargados personalizando tu consulta a la API de Instagram.
Por ejemplo, puedes especificar para qué período de tiempo se necesitan los datos (parámetros from_date y to_date), seleccionar una descarga adicional de comentarios en publicaciones, publicaciones en perfiles o por búsqueda (parámetros load_comments y load_post), configurar la actualización automática de datos (parámetro auto_update_interval) o enviar datos a la URL del usuario (parámetro callback_url), y muchos otros.

En las solicitudes GET, también puedes especificar parámetros adicionales que te permiten filtrar y ordenar los datos recibidos.

URL de callback de Instagram

Presta más atención al uso del parámetro callback_url. Puedes especificar este parámetro directamente en la solicitud POST, y después de completar la solicitud POST, recibirás una respuesta con datos en tu enlace identificado.

Ten en cuenta que si especificas el parámetro callback_url, no necesitarás enviar solicitudes GET para verificar el estado de la tarea y recibir datos.

Más detalles sobre el funcionamiento del parámetro "callback_url" puedes leer en https://data365.co/es/guides/callback-guide.

Obtener una respuesta de API en JSON de Instagram

Después de completar las solicitudes, el usuario recibe una respuesta en JSON. JSON tiene una ventaja significativa sobre otros formatos que explica su popularidad. En primer lugar, es más compacto, lo que es muy importante al intercambiar datos en Internet. En segundo lugar, JSON es más fácil de usar y mucho más fácil de leer y escribir. Fue creado originalmente para JavaScript, pero muchos otros lenguajes también tienen bibliotecas que pueden trabajar con él. Así, JSON es fácil de usar para el intercambio de datos cuando el cliente está aplicando JavaScript aunque el servidor esté escrito en Ruby/PHP/Java o cualquier otro lenguaje.

Con nuestra API de Instagram, puedes obtener datos JSON de Instagram de un perfil público de Instagram basado en una base de datos de IDs o nombres de usuario de los perfiles objetivo y publicaciones de Instagram. Los datos más populares que proporcionamos incluyen ID, nombre de usuario, biografía, foto de perfil, categoría de negocio, idioma, género y reconocimiento de edad por las últimas fotos del usuario, etc.

Ejemplo de API de Instagram

Este ejemplo muestra cómo buscar publicaciones en Instagram por hashtag y obtener todos los datos sobre ellas.

https://api.data365.co/v1.1/instagram/tag/bitcoins/update?max_posts_count=100&load_comments=1&max_comments=50&access_token=TOKEN

En esta solicitud:

• bitcoins – hashtag a buscar;
• max_posts_count=100 – el número máximo de publicaciones con el hashtag bitcoins que se descargarán;
• load_comments=1 – habilita la descarga de comentarios para cada publicación;
• max_comments=50 – el número máximo de comentarios para cada publicación que se descargarán.
  

El estado "aceptado" significa que tu solicitud ha sido aceptada para su procesamiento.

Su costo aproximado es = 7 + 100 * 5 = 507 menciones. Se cobran 7 menciones por la solicitud de búsqueda en sí, 100 menciones son el número de publicaciones que esperamos recibir, 5 es el costo estimado de una publicación con comentarios. Así que 507 es el costo estimado de la solicitud.

Sin embargo, si solo hay 20 publicaciones para tu etiqueta y estas 20 publicaciones no tienen comentarios, entonces el costo de tal solicitud será de 7 + 20 * 1 = 27 menciones. Es decir, 7 menciones es el costo de crear la solicitud de búsqueda en sí, 20 es el número de publicaciones encontradas, 1 es el costo de una publicación sin comentarios.

Por lo tanto, solo cobramos por los datos que realmente recibiste después de crear una solicitud POST.
‍

El estado de la solicitud puede tener 5 opciones: creado, pendiente, finalizado, desconocido (cuando la solicitud aún no ha sido creada, no existe) y fallo (la solicitud no se completó debido a un error). Por lo general, el proceso de ejecución de la solicitud — creado → pendiente → finalizado, toma alrededor de 1 a 5 minutos. Este tiempo puede aumentar dependiendo del número total de solicitudes y la cantidad de datos en la solicitud. Es decir, una solicitud para descargar 100 publicaciones por etiqueta tomará aproximadamente 1 minuto, pero descargar 1000 publicaciones con comentarios tomará alrededor de 5 minutos.
‍

En respuesta, recibirás una lista de publicaciones que fueron encontradas por la solicitud creada en el párrafo 1.
‍

https://api.data365.co/v1.1/instagram/post/2509278369173225328/comments?access_token=TOKEN

• 2509278369173225328 es el ID de la publicación que se descargó y para la cual deseas recibir comentarios.

Webhooks de Instagram

Webhook es la función que está disponible tanto en la API oficial de Instagram como en la API de Instagram de Data365. Los webhooks fueron creados especialmente para simplificar la mensajería sobre varios eventos: cambio de configuraciones, adición de un nuevo usuario, eliminación de un mensaje, etc. Con los webhooks oficiales de Instagram, puedes recibir notificaciones en tiempo real. Pero solo si se cumplen ciertas condiciones: los webhooks para Instagram deben configurarse con una suscripción a los campos apropiados; además, la aplicación debe estar en funcionamiento y tener los permisos apropiados. Por ejemplo, si el objeto de medios es creado por un propietario de cuenta cerrada, entonces el webhook oficial de Instagram no se enviaría. Además, los webhooks oficiales de Instagram no admiten videos de Reels.

Con la API de Instagram de Data365, también puedes configurar la recepción regular de información sobre nuevos datos. Solo necesitas especificar el parámetro auto_update_interval, que monitoreará los nuevos datos emergentes. Y el parámetro callback_url, que enviará nuevos datos a la dirección del usuario (URL). Por ejemplo, con nuestra API, puedes obtener nuevas publicaciones por hashtags o ubicaciones que sigues, nuevos comentarios en publicaciones que los usuarios dejan, etc.
Puedes ver más ejemplos de la API de Instagram en la página de Recursos.

Podemos concluir que la API de Instagram de Data365 es una herramienta confiable que puede ayudarte a obtener muchos datos públicos. Estamos completamente seguros de que es una gran opción para el crecimiento de tu negocio.