A Python client for interacting with the Box API for Instagram. This library wraps multiple Instagram endpoints including user information, media retrieval, and direct messages, allowing you to easily integrate Instagram functionality into your Python applications.
Note
I have not been able to test the DM API. Please make sure to test your implementation thoroughly before using it in production. If you encounter any issues, feel free to open an issue or submit a pull request.
- Modular Design: Separate sub-clients for general Instagram endpoints and direct message (DM) endpoints.
- Easy Integration: Instantiate a single client to access the full functionality of the Box API.
- Flexible Usage: Use DM endpoints only when needed—save overhead if your application doesn’t require them.
- Extensible: Add additional endpoints or support for other platforms with minimal changes.
You can install the package via pip or Poetry.
pip install boxapipoetry add boxapifrom boxapi import BoxApiClient
# Initialize BoxApiClient with Box API credentials
# IMPORTANT: MAKE SURE YOU ARE READING YOUR USERNAME AND PASSWORD FROM ENVIRONMENT VARIABLES
box_client = BoxApiClient("your_boxapi_username", "your_boxapi_password")
# Use the Instagram sub-client for general endpoints
user_info = box_client.instagram.get_user_info("leomessi")
print(user_info)Direct Message functionality is available through a separate sub-client. Instantiate it when needed:
from boxapi import BoxApiClient
# Initialize BoxApiClient with Box API credentials
box_client = BoxApiClient("your_boxapi_username", "your_boxapi_password")
# Use DM endpoints by providing the Instagram account credentials per call
login_response = box_client.instagram_dm.direct_login("insta_username", "insta_password")
print(login_response)Check out the examples folder for complete scripts demonstrating how to use the different features of this library (It's a work in progress).
This project is licensed under the MIT License. See the LICENSE file for details.