boxapi 1.0.0

Python client for https://boxapi.ir to crawl and read Instagram data.

BoxAPI Python

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.

Disclaimer
This project is currently in a developer preview state and may not be ready for production use. A stable version is expected to be released within the next couple of weeks. Use at your own risk and feel free to report any issues you encounter.

Table of Contents

• Features
• Installation
• Project Structure
• Usage
  • General Instagram API
  • Direct Messages
• Examples
• Contributing
• License

Features

• 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.

Installation

You can install the package via pip or Poetry.

Using pip

pip install boxapi

Using Poetry

poetry add boxapi

Usage

General Instagram API

from 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 Messages

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)

Examples

Check out the examples folder for complete scripts demonstrating how to use the different features of this library (It's a work in progress).

License

This project is licensed under the MIT License. See the LICENSE file for details.