{"id":26107127,"url":"https://github.com/amirhoseinsalimi/boxapi-python","last_synced_at":"2026-05-26T20:31:26.105Z","repository":{"id":281216501,"uuid":"944482389","full_name":"amirhoseinsalimi/boxapi-python","owner":"amirhoseinsalimi","description":"Python client for https://boxapi.ir to crawl and read Instagram data.","archived":false,"fork":false,"pushed_at":"2025-03-31T20:07:41.000Z","size":34,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-03-07T09:41:04.346Z","etag":null,"topics":["crawler","instagram","instagram-api","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amirhoseinsalimi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-07T12:26:25.000Z","updated_at":"2025-03-31T22:03:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"1d7b0b8b-9452-4c74-a9de-7aeea73c1c33","html_url":"https://github.com/amirhoseinsalimi/boxapi-python","commit_stats":null,"previous_names":["amirhoseinsalimi/boxapi-python"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/amirhoseinsalimi/boxapi-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhoseinsalimi%2Fboxapi-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhoseinsalimi%2Fboxapi-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhoseinsalimi%2Fboxapi-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhoseinsalimi%2Fboxapi-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amirhoseinsalimi","download_url":"https://codeload.github.com/amirhoseinsalimi/boxapi-python/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhoseinsalimi%2Fboxapi-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33538659,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"ssl_error","status_checked_at":"2026-05-26T15:22:15.568Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crawler","instagram","instagram-api","python","python3"],"created_at":"2025-03-09T22:43:22.173Z","updated_at":"2026-05-26T20:31:26.100Z","avatar_url":"https://github.com/amirhoseinsalimi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BoxAPI Python\n\nA Python client for interacting with the [Box API](https://boxapi.ir) 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.\n\n\u003e **Note**  \n\u003e I have not been able to test the DM API. Please make sure to test your implementation thoroughly before using it in \n\u003e production. If you encounter any issues, feel free to open an issue or submit a pull request.\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Project Structure](#project-structure)\n- [Usage](#usage)\n  - [General Instagram API](#general-instagram-api)\n  - [Direct Messages](#direct-messages)\n- [Examples](#examples)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- **Modular Design**: Separate sub-clients for general Instagram endpoints and direct message (DM) endpoints.\n- **Easy Integration**: Instantiate a single client to access the full functionality of the Box API.\n- **Flexible Usage**: Use DM endpoints only when needed—save overhead if your application doesn’t require them.\n- **Extensible**: Add additional endpoints or support for other platforms with minimal changes.\n\n## Installation\n\nYou can install the package via [pip](https://pypi.org/project/pip/) or [Poetry](https://python-poetry.org/).\n\n### Using pip\n\n```bash\npip install boxapi\n```\n\n### Using Poetry\n\n```bash\npoetry add boxapi\n```\n\n## Usage\n\n### General Instagram API\n\n```python\nfrom boxapi import BoxApiClient\n\n# Initialize BoxApiClient with Box API credentials\n# IMPORTANT: MAKE SURE YOU ARE READING YOUR USERNAME AND PASSWORD FROM ENVIRONMENT VARIABLES\nbox_client = BoxApiClient(\"your_boxapi_username\", \"your_boxapi_password\")\n\n# Use the Instagram sub-client for general endpoints\nuser_info = box_client.instagram.get_user_info(\"leomessi\")\n\nprint(user_info)\n```\n\n### Direct Messages\n\nDirect Message functionality is available through a separate sub-client. Instantiate it when needed:\n\n```python\nfrom boxapi import BoxApiClient\n\n# Initialize BoxApiClient with Box API credentials\nbox_client = BoxApiClient(\"your_boxapi_username\", \"your_boxapi_password\")\n\n# Use DM endpoints by providing the Instagram account credentials per call\nlogin_response = box_client.instagram_dm.direct_login(\"insta_username\", \"insta_password\")\nprint(login_response)\n```\n\n## Examples\n\nCheck out the [examples](./examples) folder for complete scripts demonstrating how to use the different features of this library (It's a work in progress).\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famirhoseinsalimi%2Fboxapi-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famirhoseinsalimi%2Fboxapi-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famirhoseinsalimi%2Fboxapi-python/lists"}