apkpure 0.3.0

An API for interacting with the APK Pure website, allowing you to search for apps, retrieve app information, and download apps programmatically.

Apk Pure Api

An API for interacting with the APK Pure website, allowing you to search for apps, retrieve app information, and download apps programmatically.

Features

• Search for Apps: Find apps on APK Pure by querying their name or keywords.
• Get App Info: Retrieve detailed information about a specific app, including version, developer, ratings, and more.
• Download App: Programmatically download the APK files of the apps.

Getting Started

Prerequisites

• Python 3.7+
• requests library
• beautifulsoup4 library
• tqdm library

Installation

First Method:

pip install apkpure

Second Method:

1. Clone the repository:

git clone https://github.com/anishomsy/apkpure.git
cd apkpure

2. Create a virtual environment:

   python -m venv venv
   

3. Activate the virtual environment:

   • On Windows:

     .\venv\Scripts\activate
     

   • On macOS and Linux:

     source venv/bin/activate
     

4. Install the required libraries:

   pip install requests beautifulsoup4 tqdm
   

   or

   pip install -r requirements.txt
   

Usage

Here's a quick example of how to use the ApkPure class:

from apkpure.apkpure import ApkPure

# Initialize the API
api = ApkPure()

# Search for an app and get top result
top_result = api.search_top("WhatsApp")
print(top_result)

# Search for all results
all_results = api.search_all("WhatsApp")
print(all_results)

# Get app versions
versions = api.get_versions("WhatsApp")
print(versions)

# Get app info
app_info = api.get_info("WhatsApp")
print(app_info)

# Download the latest version of an app
download_path = api.download("whatsapp")
print(download_path)

# Download a specific version of an app
api.download("WhatsApp", version="2.21.1.15")

Class: ApkPure

A class to interact with ApkPure for searching apps, retrieving app information, and downloading APK files.

__init__(headers: dict | None = None) -> None

Initialize the ApkPure instance with optional headers.

• Parameters:
  • headers (dict | None): Optional headers for HTTP requests.

search_top(name: str) -> str

Search for the top result of an app on APK Pure.

• Parameters:
  • name (str): The name of the app to search for.
• Returns:
  • str: A JSON string containing details of the top search result.

search_all(name: str) -> str

Search for all results of an app on APK Pure.

• Parameters:
  • name (str): The name of the app to search for.
• Returns:
  • str: A JSON string containing details of all search results.

get_versions(name: str) -> str

Retrieve all available versions of the specified app.

• Parameters:
  • name (str): The name of the app.
• Returns:
  • str: A JSON string containing the details of all available versions.

get_info(name: str) -> str

Retrieve detailed information about the specified app.

• Parameters:
  • name (str): The name of the app.
• Returns:
  • str: A JSON string containing detailed information about the app.

download(name: str, version: str = "") -> str | None

Download the specified version of the app. If no version is specified, download the latest version.

• Parameters:
  • name (str): The name of the app.
  • version (str, optional): The version of the app to download. Defaults to the latest version.
• Returns:
  • str | None: The real path to the downloaded APK file, or None if the version is invalid.

Contributing

Contributions are welcome! Here's how you can contribute:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature-branch).
6. Open a pull request.

Please make sure to update tests as appropriate.

Contact

If you have any questions, suggestions, or feedback, feel free to contact me:

• GitHub: anishomsy

License

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