An API for interacting with the APK Pure website, allowing you to search for apps, retrieve app information, and download apps programmatically.
Project description
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
librarybeautifulsoup4
librarytqdm
library
Installation
First Method:
pip install apkpure
Second Method:
1. Clone the repository:git clone https://github.com/anishomsy/apkpure.git
cd apkpure
-
Create a virtual environment:
python -m venv venv
-
Activate the virtual environment:
-
On Windows:
.\venv\Scripts\activate
-
On macOS and Linux:
source venv/bin/activate
-
-
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, orNone
if the version is invalid.
Contributing
Contributions are welcome! Here's how you can contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Make your changes.
- Commit your changes (
git commit -m 'Add some feature'
). - Push to the branch (
git push origin feature-branch
). - 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.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.