apksearch 1.2.5__tar.gz → 1.2.7__tar.gz

{apksearch-1.2.5 → apksearch-1.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: apksearch
-Version: 1.2.5
+Version: 1.2.7
 Summary: Search for apks on varius websites
 Author-email: Abhi <allinoneallinone00@gmail.com>
 License: MIT License
@@ -50,26 +50,37 @@ Requires-Dist: pytest>=7.4.3; extra == "dev"
 Requires-Dist: black>=23.12.1; extra == "dev"
 Requires-Dist: flake8>=6.1.0; extra == "dev"
 
-# apksearch
+<h1 align="center">apksearch</h1>
 
 `apksearch` is a Python library designed to search for APK files on different APK websites, such as APKPure and APKMirror. It allows users to find APKs, check for available versions, and retrieve download links.
 
 **The Inspiration:**
 There were countless occasions when I needed a specific APK for a package name, only to find it unavailable on popular platforms. This led to the tedious task of manually visiting multiple websites and searching one by one.
+<details>
+    <summary>screenshot</summary>
+    <p align="center">
+        <img width="500" src="https://github.com/user-attachments/assets/cd54eaeb-a56b-40b3-835f-b48b1e7772f3"></img><br>
+        As you can see, Roblox version <code>2.647.716</code> is not available on APKPure and APKCombo, this helped me avoid going through these sites.
+    </p>
+</details>
+
+**P.S:** If you're looking for an APK downloader, I highly recommend using [apkeep](https://github.com/EFForg/apkeep).
 
 # Features
 
 - **Search APKs:** The library provides methods to search for APKs using package names.
-- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from APKPure and APKMirror.
+- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from various websites.
 - **Command-Line Interface:** A CLI is available for users to search for APKs directly from the command line.
 
 ## Supported Websites
 
 - [APKPure](https://apkpure.net/)
 - [APKMirror](https://www.apkmirror.com/)
+- [Aptoide](https://en.aptoide.com/)
 - [APKCombo](https://apkcombo.app/)
 - [APKFab](https://apkfab.com/)
 - [Appteka](https://appteka.store/)
+- [APKAD](https://apk.ad/)
 
 > [!NOTE]
 > **For site owners:**
@@ -79,7 +90,7 @@ There were countless occasions when I needed a specific APK for a package name,
 
 ## Installation
 
-To install the `apksearch` library, use the following command:
+To install/upgrade the `apksearch` library, use the following command:
 
 ```sh
 pip install -U git+https://github.com/AbhiTheModder/apksearch.git
@@ -91,6 +102,12 @@ OR, through pip:
 pip install -U apksearch
 ```
 
+OR, if you've cloned the repository locally you can do so via:
+
+```sh
+pip install -U . # or path to the local clone
+```
+
 ## Usage
 
 ### Command-Line Interface
@@ -134,19 +151,25 @@ if result:
 #### `APKPure` | `APKCombo` | `APKFab`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKPure and returns the title and link if found.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
 - **`find_versions(self, apk_link: str) -> list[tuple[str, str]]`**: Finds and returns a list of versions and their download links for the given APK link.
 
 #### `APKMirror`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKMirror and returns the title and link if found.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
 - **`find_version(self, apk_link: str, version: str) -> str`**: Finds and returns the download link for the given APK link and version.
 
-#### `AppTeka`
+#### `AppTeka` | `APKAD`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self, version: str = None) -> None | tuple[str, str]`**: Searches for the APK on AppTeka and returns the title and link if found. If a version is provided, it checks if that version is available and returns the corresponding download link, None otherwise. If no version is provided, it returns the link for the latest version available.
+- **`search_apk(self, version: str = None) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found. If a version is provided, it checks if that version is available and returns the corresponding download link, None otherwise. If no version is provided, it returns the link for the latest version available.
+
+#### `Aptoide`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
+- **`find_versions(self, apk_link: str, version: str) -> list[str]`**: Finds and returns the download links for the given APK link and versions list.
 
 ### Testing
 
@@ -165,8 +188,6 @@ pytest
 - [APKUpdater](https://github.com/rumboalla/apkupdater) for APKMirror API.
 - [apkeep](https://github.com/EFForg/apkeep) for APKPure API.
 
-**Recommendation:** If you're looking for an APK downloader, I highly recommend using [apkeep](https://github.com/EFForg/apkeep).
-
 ## License
 
 This project is licensed under the MIT License. See the [LICENSE](https://github.com/AbhiTheModder/apksearch/blob/main/LICENSE) file for more details.

{apksearch-1.2.5 → apksearch-1.2.7}/README.md

@@ -1,23 +1,34 @@
-# apksearch
+<h1 align="center">apksearch</h1>
 
 `apksearch` is a Python library designed to search for APK files on different APK websites, such as APKPure and APKMirror. It allows users to find APKs, check for available versions, and retrieve download links.
 
 **The Inspiration:**
 There were countless occasions when I needed a specific APK for a package name, only to find it unavailable on popular platforms. This led to the tedious task of manually visiting multiple websites and searching one by one.
+<details>
+    <summary>screenshot</summary>
+    <p align="center">
+        <img width="500" src="https://github.com/user-attachments/assets/cd54eaeb-a56b-40b3-835f-b48b1e7772f3"></img><br>
+        As you can see, Roblox version <code>2.647.716</code> is not available on APKPure and APKCombo, this helped me avoid going through these sites.
+    </p>
+</details>
+
+**P.S:** If you're looking for an APK downloader, I highly recommend using [apkeep](https://github.com/EFForg/apkeep).
 
 # Features
 
 - **Search APKs:** The library provides methods to search for APKs using package names.
-- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from APKPure and APKMirror.
+- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from various websites.
 - **Command-Line Interface:** A CLI is available for users to search for APKs directly from the command line.
 
 ## Supported Websites
 
 - [APKPure](https://apkpure.net/)
 - [APKMirror](https://www.apkmirror.com/)
+- [Aptoide](https://en.aptoide.com/)
 - [APKCombo](https://apkcombo.app/)
 - [APKFab](https://apkfab.com/)
 - [Appteka](https://appteka.store/)
+- [APKAD](https://apk.ad/)
 
 > [!NOTE]
 > **For site owners:**
@@ -27,7 +38,7 @@ There were countless occasions when I needed a specific APK for a package name,
 
 ## Installation
 
-To install the `apksearch` library, use the following command:
+To install/upgrade the `apksearch` library, use the following command:
 
 ```sh
 pip install -U git+https://github.com/AbhiTheModder/apksearch.git
@@ -39,6 +50,12 @@ OR, through pip:
 pip install -U apksearch
 ```
 
+OR, if you've cloned the repository locally you can do so via:
+
+```sh
+pip install -U . # or path to the local clone
+```
+
 ## Usage
 
 ### Command-Line Interface
@@ -82,19 +99,25 @@ if result:
 #### `APKPure` | `APKCombo` | `APKFab`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKPure and returns the title and link if found.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
 - **`find_versions(self, apk_link: str) -> list[tuple[str, str]]`**: Finds and returns a list of versions and their download links for the given APK link.
 
 #### `APKMirror`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKMirror and returns the title and link if found.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
 - **`find_version(self, apk_link: str, version: str) -> str`**: Finds and returns the download link for the given APK link and version.
 
-#### `AppTeka`
+#### `AppTeka` | `APKAD`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self, version: str = None) -> None | tuple[str, str]`**: Searches for the APK on AppTeka and returns the title and link if found. If a version is provided, it checks if that version is available and returns the corresponding download link, None otherwise. If no version is provided, it returns the link for the latest version available.
+- **`search_apk(self, version: str = None) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found. If a version is provided, it checks if that version is available and returns the corresponding download link, None otherwise. If no version is provided, it returns the link for the latest version available.
+
+#### `Aptoide`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
+- **`find_versions(self, apk_link: str, version: str) -> list[str]`**: Finds and returns the download links for the given APK link and versions list.
 
 ### Testing
 
@@ -113,8 +136,6 @@ pytest
 - [APKUpdater](https://github.com/rumboalla/apkupdater) for APKMirror API.
 - [apkeep](https://github.com/EFForg/apkeep) for APKPure API.
 
-**Recommendation:** If you're looking for an APK downloader, I highly recommend using [apkeep](https://github.com/EFForg/apkeep).
-
 ## License
 
 This project is licensed under the MIT License. See the [LICENSE](https://github.com/AbhiTheModder/apksearch/blob/main/LICENSE) file for more details.

{apksearch-1.2.5 → apksearch-1.2.7}/apksearch/__init__.py

@@ -3,5 +3,7 @@ from .sites.apkmirror import APKMirror
 from .sites.appteka import AppTeka
 from .sites.apkcombo import APKCombo
 from .sites.apkfab import APKFab
+from .sites.apkad import APKad
+from .sites.aptoide import Aptoide
 
-__all__ = ["APKPure", "APKMirror", "AppTeka", "APKCombo", "APKFab"]
+__all__ = ["APKPure", "APKMirror", "AppTeka", "APKCombo", "APKFab", "APKad", "Aptoide"]

{apksearch-1.2.5 → apksearch-1.2.7}/apksearch/cli.py

@@ -1,6 +1,7 @@
 import argparse
 
-from apksearch import APKPure, APKMirror, AppTeka, APKCombo, APKFab
+from collections.abc import Callable
+from apksearch import APKPure, APKMirror, AppTeka, APKCombo, APKFab, APKad, Aptoide
 from requests.exceptions import ConnectionError, ConnectTimeout
 
 # Color codes
@@ -11,6 +12,21 @@ YELLOW = "\033[93m"
 NC = "\033[0m"
 
 
+def search(
+    func: Callable[[str, str], object],
+    pkg_name: str,
+    version: str | None,
+    log_err: bool = False,
+) -> None:
+    try:
+        func(pkg_name, version)
+    except Exception as exc:
+        if log_err:
+            print(f"Error in {func.__name__}: {exc}")
+        else:
+            pass
+
+
 def search_apkpure(pkg_name: str, version: str | None) -> None:
     apkpure = APKPure(pkg_name)
     try:
@@ -63,6 +79,23 @@ def search_apkfab(pkg_name: str, version: str | None) -> None:
         print(f"{BOLD}APKFab:{NC} No Results!")
 
 
+def search_apkad(pkg_name: str, version: str | None) -> None:
+    apkad = APKad(pkg_name)
+    try:
+        result_apkad: tuple[str, str] | None = apkad.search_apk()
+    except (ConnectionError, ConnectTimeout):
+        result_apkad = None
+        print(f"{RED}Failed to resolve 'api.apk.ad'!{NC}")
+    if result_apkad:
+        title, apk_link = result_apkad
+        print(f"{BOLD}APKAD:{NC} Found {GREEN}{title}{NC}") if title else None
+        print(
+            f"      ╰─> {BOLD}Link: {YELLOW}{apk_link}{NC}"
+        ) if not version else print("      ╰─> Doesn't support version search!")
+    else:
+        print(f"{BOLD}APKAD:{NC} No Results!")
+
+
 def search_apkcombo(pkg_name: str, version: str | None) -> None:
     apkcombo = APKCombo(pkg_name)
     try:
@@ -134,27 +167,59 @@ def search_appteka(pkg_name: str, version: str | None) -> None:
         print(f"{BOLD}AppTeka:{NC} No Results!")
 
 
+def search_aptoide(pkg_name: str, version: str | None) -> None:
+    aptoide = Aptoide(pkg_name)
+    try:
+        result_aptoide: tuple[str, str] | None = aptoide.search_apk()
+    except (ConnectionError, ConnectTimeout):
+        result_aptoide = None
+        print(f"{RED}Failed to resolve 'aptoide.com'!{NC}")
+    if result_aptoide:
+        title, apk_link = result_aptoide
+        print(f"{BOLD}Aptoide:{NC} Found {GREEN}{title}{NC}") if title else None
+        print(f"      ╰─> {BOLD}Link: {YELLOW}{apk_link}{NC}") if not version else None
+        if version:
+            versions: list[str | None] = aptoide.find_versions(apk_link)
+            if versions:
+                if version in versions:
+                    print(
+                        f"      ╰─> {BOLD}Version: {GREEN}{version}{NC} - {YELLOW}{apk_link}versions{NC}"
+                    )
+                else:
+                    print(f"{BOLD}Aptoide:{NC} Version {RED}{version}{NC} not found!")
+    else:
+        print(f"{BOLD}Aptoide:{NC} No Results!")
+
+
 def main():
     parser = argparse.ArgumentParser(
         prog="APKSearch", description="Search for APKs on various websites"
     )
     parser.add_argument("pkg_name", help="The package name of the APK")
     parser.add_argument("--version", help="The version of the APK", required=False)
+    parser.add_argument(
+        "--log_err", help="Enable error logs", action="store_true", required=False
+    )
     args = parser.parse_args()
 
     pkg_name = args.pkg_name
     version = args.version
+    log_err = args.log_err
     print(f"{BOLD}Searching for {YELLOW}{pkg_name}{NC}...")
     # Initiate search on apkpure
-    search_apkpure(pkg_name, version)
+    search(search_apkpure, pkg_name, version, log_err)
     # Initiate search on apkmirror
-    search_apkmirror(pkg_name, version)
+    search(search_apkmirror, pkg_name, version, log_err)
+    # Initiate search on aptoide
+    search(search_aptoide, pkg_name, version, log_err)
     # Initiate search on appteka
-    search_appteka(pkg_name, version)
+    search(search_appteka, pkg_name, version, log_err)
     # Initiate search on apkcombo
-    search_apkcombo(pkg_name, version)
+    search(search_apkcombo, pkg_name, version, log_err)
     # Initiate search on apkfab
-    search_apkfab(pkg_name, version)
+    search(search_apkfab, pkg_name, version, log_err)
+    # Initiate search on apkad
+    search(search_apkad, pkg_name, version, log_err)
 
 
 if __name__ == "__main__":

apksearch-1.2.7/apksearch/sites/apkad.py

@@ -0,0 +1,109 @@
+import json
+from bs4 import BeautifulSoup
+import requests
+
+
+class APKad:
+    """
+    This class provides methods to search for an APK on APKAD based on package name,
+    and to find available versions and their download links for a given APK link.
+
+    Parameters:
+        pkg_name (str): The package name of the APK to search for.
+
+    Attributes:
+        pkg_name (str): The package name of the APK to search for.
+        base_url (str): The base URL of the APKAD website.
+        search_url (str): The URL used to search for APKs on APKAD.
+        headers (dict): The headers used for making HTTP requests.
+        session (requests.Session): The session object used for making HTTP requests.
+
+    Methods:
+        search_apk() -> None | tuple[str, str]:
+            Searches for the APK on APKAD and returns the title and link if found.
+    """
+
+    def __init__(self, pkg_name: str):
+        self.pkg_name = pkg_name
+        self.base_url = "https://downloader.apk.ad"
+        self.api_url = "https://api.apk.ad"
+        self.search_url = (
+            self.api_url
+            + f"/get?hl=en&package={self.pkg_name}&device=phone&arch=arm64-v8a&vc=&device_id="
+        )
+        self.headers = {
+            "accept": "text/event-stream",
+            "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
+            "cache-control": "no-cache",
+            "dnt": "1",
+            "origin": "https://downloader.apk.ad",
+            "pragma": "no-cache",
+            "priority": "u=1, i",
+            "referer": "https://downloader.apk.ad/",
+            "sec-ch-ua": '"Microsoft Edge";v="131", "Chromium";v="131", "Not_A Brand";v="24"',
+            "sec-ch-ua-mobile": "?0",
+            "sec-ch-ua-platform": '"Windows"',
+            "sec-fetch-dest": "empty",
+            "sec-fetch-mode": "cors",
+            "sec-fetch-site": "same-site",
+            "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36 Edg/131.0.0.0",
+        }
+        self.session = requests.Session()
+
+    def search_apk(self) -> None | tuple[str, str]:
+        """
+        Searches for the APK on APKAD and returns the title and link if found.
+
+        Returns:
+            None: If no matching APK is found.
+            tuple[str, str]: A tuple containing the title and link of the matching APK if found.
+        """
+        url = self.search_url
+        response = self.session.get(url, headers=self.headers, stream=True)
+        stream_response = ""
+        for line in response.iter_lines():
+            if line:
+                line_response = line.decode("utf-8")
+                if '"progress":100' in line_response:
+                    line_response = line_response[6:]
+                    stream_response += line_response
+                    break
+        if stream_response:
+            data = json.loads(stream_response)
+            html_body = data["html"]
+            soup = BeautifulSoup(html_body, "html.parser")
+            if not soup:
+                return None
+            title = soup.find("li", {"class": "_title"})
+            if title:
+                title = title.text.strip()
+                button = soup.find(
+                    "button", {"onclick": True, "id": "downloadButtonapk"}
+                )["onclick"]
+                if button:
+                    zip_args = [
+                        arg.strip("'")
+                        for arg in button.split("zip(")[1].split(")")[0].split(",")
+                    ]
+                    h = zip_args[0]  # hash
+                    p = zip_args[-1]  # type
+                    token = zip_args[1]  # token
+                    ip = zip_args[2]  # ip
+                    google_id = zip_args[3]  # package_name
+                    t = zip_args[4]  # time
+                    apk_url = f"https://zip.apk.ad/compress?h={h}&p={p}&token={token}&ip={ip}&google_id={google_id}&t={t}"
+                    apk_url_response = self.session.get(
+                        url=apk_url, headers=self.headers, stream=True
+                    )
+                    for line in apk_url_response.iter_lines():
+                        if line:
+                            line_response = line.decode("utf-8")
+                            if "File is ready for download." in line_response:
+                                line_response = json.loads(line_response)
+                                line_html = line_response["html"]
+                                line_soup = BeautifulSoup(line_html, "html.parser")
+                                download_link = line_soup.find("a")["href"]
+                                if download_link.endswith("\n"):
+                                    download_link = download_link[:-1]
+                                return title, download_link
+        return None

{apksearch-1.2.5 → apksearch-1.2.7}/apksearch/sites/apkcombo.py

@@ -28,7 +28,7 @@ class APKCombo:
     def __init__(self, pkg_name: str):
         self.pkg_name = pkg_name
         self.base_url = "https://apkcombo.app"
-        self.search_url = self.base_url + "/search/"
+        self.search_url = self.base_url + "/search"
         self.headers = {
             "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
             "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
@@ -59,7 +59,7 @@ class APKCombo:
             tuple[str, str]: A tuple containing the title and link of the matching APK if found.
         """
         pkg_name = self.pkg_name
-        url = self.search_url + pkg_name
+        url = self.search_url + "/" + pkg_name
         response: requests.Response = self.session.get(
             url, headers=self.headers, allow_redirects=False
         )

apksearch-1.2.7/apksearch/sites/aptoide.py

@@ -0,0 +1,102 @@
+import re
+from bs4 import BeautifulSoup
+import requests
+
+
+class Aptoide:
+    """
+    This class provides methods to search for an APK on Aptoide based on package name,
+    and to find available versions and their download links for a given APK link.
+
+    Parameters:
+        pkg_name (str): The package name of the APK to search for.
+
+    Attributes:
+        pkg_name (str): The package name of the APK to search for.
+        api_url (str): The base URL for the Aptoide API.
+        search_url (str): The URL used to search for APKs on Aptoide.
+        headers (dict): The headers used for making HTTP requests.
+        session (requests.Session): The session object used for making HTTP requests.
+
+    Methods:
+        search_apk() -> None | tuple[str, str]:
+            Searches for the APK on Aptoide and returns the title and link if found.
+
+        find_versions(apk_link: str) -> list[str | None]:
+            Finds and returns a list of versions for the given APK link.
+    """
+
+    def __init__(self, pkg_name: str):
+        self.pkg_name = pkg_name
+        self.api_url = "https://ws75.aptoide.com/api/7"
+        self.search_url = f"{self.api_url}/apps/search?limit=1&query="
+        self.headers = {
+            "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
+            "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
+            "cache-control": "no-cache",
+            "dnt": "1",
+            "pragma": "no-cache",
+            "priority": "u=0, i",
+            "referer": "https://en.aptoide.com/",
+            "sec-ch-ua": '"Not A(Brand";v="8", "Chromium";v="132", "Microsoft Edge";v="132"',
+            "sec-ch-ua-mobile": "?0",
+            "sec-ch-ua-platform": '"Windows"',
+            "sec-fetch-dest": "document",
+            "sec-fetch-mode": "navigate",
+            "sec-fetch-site": "same-origin",
+            "sec-fetch-user": "?1",
+            "upgrade-insecure-requests": "1",
+            "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36 Edg/131.0.0.0",
+        }
+        self.session = requests.Session()
+
+    def search_apk(self) -> None | tuple[str, str]:
+        """
+        Searches for the APK on Aptoide and returns the title and link if found.
+
+        Returns:
+            None: If no matching APK is found.
+            tuple[str, str]: A tuple containing the title and link of the matching APK if found.
+        """
+        pkg_name = self.pkg_name
+        url = self.search_url + pkg_name
+        response: requests.Response = self.session.get(url, headers=self.headers)
+        data = response.json()
+        if data and data["info"]["status"] == "OK":
+            lis = data["datalist"]["list"]
+            if lis:
+                package = data["datalist"]["list"][0]["package"]
+                apk_title = data["datalist"]["list"][0]["name"]
+                if package == pkg_name:
+                    app_id: int = data["datalist"]["list"][0]["id"]
+                    meta_url = self.api_url + f"/app/getMeta?app_id={app_id}"
+                    meta_response: requests.Response = self.session.get(
+                        meta_url, headers=self.headers
+                    )
+                    meta_data = meta_response.json()
+                    if meta_data and meta_data["info"]["status"] == "OK":
+                        url = meta_data["data"]["urls"]["w"].split("?")[0]
+                        return apk_title, url
+        return None
+
+    def find_versions(self, apk_link: str) -> list[str | None]:
+        """
+        Finds and returns a list of versions for the given APK link.
+
+        Parameters:
+            apk_link (str): The link to the APK on the Aptoide website.
+
+        Returns:
+           list[str | None]: A list of version strings for the given APK link.
+        """
+        versions_info = []
+
+        url = apk_link + "/versions"
+        response: requests.Response = self.session.get(url, headers=self.headers)
+        soup = BeautifulSoup(response.content, "html.parser")
+        version_spans = soup.find_all("span", string=re.compile(r"^\d+\.\d+\.\d+$"))
+        for span in version_spans:
+            version = span.text
+            versions_info.append(version)
+
+        return versions_info

{apksearch-1.2.5 → apksearch-1.2.7}/apksearch.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: apksearch
-Version: 1.2.5
+Version: 1.2.7
 Summary: Search for apks on varius websites
 Author-email: Abhi <allinoneallinone00@gmail.com>
 License: MIT License
@@ -50,26 +50,37 @@ Requires-Dist: pytest>=7.4.3; extra == "dev"
 Requires-Dist: black>=23.12.1; extra == "dev"
 Requires-Dist: flake8>=6.1.0; extra == "dev"
 
-# apksearch
+<h1 align="center">apksearch</h1>
 
 `apksearch` is a Python library designed to search for APK files on different APK websites, such as APKPure and APKMirror. It allows users to find APKs, check for available versions, and retrieve download links.
 
 **The Inspiration:**
 There were countless occasions when I needed a specific APK for a package name, only to find it unavailable on popular platforms. This led to the tedious task of manually visiting multiple websites and searching one by one.
+<details>
+    <summary>screenshot</summary>
+    <p align="center">
+        <img width="500" src="https://github.com/user-attachments/assets/cd54eaeb-a56b-40b3-835f-b48b1e7772f3"></img><br>
+        As you can see, Roblox version <code>2.647.716</code> is not available on APKPure and APKCombo, this helped me avoid going through these sites.
+    </p>
+</details>
+
+**P.S:** If you're looking for an APK downloader, I highly recommend using [apkeep](https://github.com/EFForg/apkeep).
 
 # Features
 
 - **Search APKs:** The library provides methods to search for APKs using package names.
-- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from APKPure and APKMirror.
+- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from various websites.
 - **Command-Line Interface:** A CLI is available for users to search for APKs directly from the command line.
 
 ## Supported Websites
 
 - [APKPure](https://apkpure.net/)
 - [APKMirror](https://www.apkmirror.com/)
+- [Aptoide](https://en.aptoide.com/)
 - [APKCombo](https://apkcombo.app/)
 - [APKFab](https://apkfab.com/)
 - [Appteka](https://appteka.store/)
+- [APKAD](https://apk.ad/)
 
 > [!NOTE]
 > **For site owners:**
@@ -79,7 +90,7 @@ There were countless occasions when I needed a specific APK for a package name,
 
 ## Installation
 
-To install the `apksearch` library, use the following command:
+To install/upgrade the `apksearch` library, use the following command:
 
 ```sh
 pip install -U git+https://github.com/AbhiTheModder/apksearch.git
@@ -91,6 +102,12 @@ OR, through pip:
 pip install -U apksearch
 ```
 
+OR, if you've cloned the repository locally you can do so via:
+
+```sh
+pip install -U . # or path to the local clone
+```
+
 ## Usage
 
 ### Command-Line Interface
@@ -134,19 +151,25 @@ if result:
 #### `APKPure` | `APKCombo` | `APKFab`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKPure and returns the title and link if found.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
 - **`find_versions(self, apk_link: str) -> list[tuple[str, str]]`**: Finds and returns a list of versions and their download links for the given APK link.
 
 #### `APKMirror`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKMirror and returns the title and link if found.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
 - **`find_version(self, apk_link: str, version: str) -> str`**: Finds and returns the download link for the given APK link and version.
 
-#### `AppTeka`
+#### `AppTeka` | `APKAD`
 
 - **`__init__(self, pkg_name: str)`**: Initializes with the package name.
-- **`search_apk(self, version: str = None) -> None | tuple[str, str]`**: Searches for the APK on AppTeka and returns the title and link if found. If a version is provided, it checks if that version is available and returns the corresponding download link, None otherwise. If no version is provided, it returns the link for the latest version available.
+- **`search_apk(self, version: str = None) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found. If a version is provided, it checks if that version is available and returns the corresponding download link, None otherwise. If no version is provided, it returns the link for the latest version available.
+
+#### `Aptoide`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK and returns the title and link if found.
+- **`find_versions(self, apk_link: str, version: str) -> list[str]`**: Finds and returns the download links for the given APK link and versions list.
 
 ### Testing
 
@@ -165,8 +188,6 @@ pytest
 - [APKUpdater](https://github.com/rumboalla/apkupdater) for APKMirror API.
 - [apkeep](https://github.com/EFForg/apkeep) for APKPure API.
 
-**Recommendation:** If you're looking for an APK downloader, I highly recommend using [apkeep](https://github.com/EFForg/apkeep).
-
 ## License
 
 This project is licensed under the MIT License. See the [LICENSE](https://github.com/AbhiTheModder/apksearch/blob/main/LICENSE) file for more details.

{apksearch-1.2.5 → apksearch-1.2.7}/apksearch.egg-info/SOURCES.txt

@@ -11,13 +11,16 @@ apksearch.egg-info/entry_points.txt
 apksearch.egg-info/requires.txt
 apksearch.egg-info/top_level.txt
 apksearch/sites/__init__.py
+apksearch/sites/apkad.py
 apksearch/sites/apkcombo.py
 apksearch/sites/apkfab.py
 apksearch/sites/apkmirror.py
 apksearch/sites/apkpure.py
 apksearch/sites/appteka.py
+apksearch/sites/aptoide.py
 tests/test_apkcombo.py
 tests/test_apkfab.py
 tests/test_apkmirror.py
 tests/test_apkpure.py
-tests/test_appteka.py
+tests/test_appteka.py
+tests/test_aptoide.py

{apksearch-1.2.5 → apksearch-1.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "apksearch"
-version = "1.2.5"
+version = "1.2.7"
 description = "Search for apks on varius websites"
 authors = [{ name = "Abhi", email = "allinoneallinone00@gmail.com" }]
 license = { file = "LICENSE" }

{apksearch-1.2.5 → apksearch-1.2.7}/tests/test_apkmirror.py

@@ -31,7 +31,7 @@ def test_find_versions_nfound():
 
 def test_find_versions_found():
     query = "com.roblox.client"
-    version = "2.652.765"
+    version = "2.654.474"
     apkmirror = APKMirror(query)
     result = apkmirror.search_apk()
 

apksearch-1.2.7/tests/test_aptoide.py

@@ -0,0 +1,29 @@
+from apksearch.sites.aptoide import Aptoide
+
+
+def test_search_apk():
+    query = "com.roblox.client"
+    aptoide = Aptoide(query)
+    result = aptoide.search_apk()
+
+    assert result is not None, "No APK found for the query."
+    assert isinstance(result, tuple), "Result should be a tuple."
+    assert len(result) == 2, "Tuple should contain two elements."
+    assert isinstance(result[0], str), "First element of the tuple should be a string."
+    assert isinstance(result[1], str), "Second element of the tuple should be a string."
+
+
+def test_find_versions():
+    query = "com.roblox.client"
+    aptoide = Aptoide(query)
+    result = aptoide.search_apk()
+
+    if result:
+        apk_link = result[1]
+        versions = aptoide.find_versions(apk_link)
+
+        assert isinstance(versions, list), "Versions should be a list."
+        assert len(versions) > 0, "No versions found."
+        assert all(
+            isinstance(version, str) for version in versions
+        ), "Each version should be a string."