Skip to content

Latest commit

 

History

History
201 lines (133 loc) · 4.45 KB

README.md

File metadata and controls

201 lines (133 loc) · 4.45 KB

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

  1. Create a virtual environment:

    python -m venv venv

  2. Activate the virtual environment:

    • On Windows:

      .\venv\Scripts\activate

    • On macOS and Linux:

      source venv/bin/activate

  3. 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:

License

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