Metadata-Version: 2.4
Name: askpablos-api
Version: 0.2.0
Summary: Professional Python client for the AskPablos proxy API service
Author-email: Fawad Ali <fawadstar6@gmail.com>
Maintainer-email: Fawad Ali <fawadstar6@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/fawadss1/askpablos_api
Project-URL: Documentation, https://askpablos-api.readthedocs.io/en/latest/
Project-URL: Repository, https://github.com/fawadss1/askpablos_api
Project-URL: Issues, https://github.com/fawadss1/askpablos_api/issues
Project-URL: PyPI, https://pypi.org/project/askpablos-api/
Keywords: proxy,api,web-scraping,browser,http-client,askpablos
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Internet :: Proxy Servers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Networking
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=2.0; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: flake8>=3.8; extra == "dev"
Requires-Dist: mypy>=0.900; extra == "dev"
Requires-Dist: pre-commit>=2.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=4.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=1.0; extra == "docs"
Requires-Dist: myst-parser>=0.15; extra == "docs"
Dynamic: license-file

# AskPablos API Client

[![PyPI Version](https://img.shields.io/pypi/v/askpablos-api.svg)](https://pypi.org/project/askpablos-api/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/askpablos-api.svg)](https://pypi.org/project/askpablos-api/)
[![Supported Python Versions](https://img.shields.io/pypi/pyversions/askpablos-api.svg)](https://pypi.org/project/askpablos-api/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![GitHub Stars](https://img.shields.io/github/stars/fawadss1/askpablos_api.svg)](https://github.com/fawadss1/askpablos_api/stargazers)
[![GitHub Issues](https://img.shields.io/github/issues/fawadss1/askpablos_api.svg)](https://github.com/fawadss1/askpablos_api/issues)
[![GitHub Last Commit](https://img.shields.io/github/last-commit/fawadss1/askpablos_api.svg)](https://github.com/fawadss1/askpablos_api/commits)

A professional Python client library for making GET requests through the AskPablos proxy API service. This library provides a clean, secure, and easy-to-use interface for fetching web pages and APIs through the AskPablos proxy infrastructure with rotating IP addresses and advanced browser automation support.

## Documentation

Full documentation is available at: [https://askpablos-api.readthedocs.io/en/latest/](https://askpablos-api.readthedocs.io/en/latest/)

## Key Features

- 🔐 **Secure Authentication**: HMAC-SHA256 signature-based authentication
- 🌐 **Proxy Support**: Route requests through rotating proxies
- 🤖 **Browser Automation**: Full browser support with JavaScript rendering
- 📸 **Screenshot Capture**: Take screenshots of web pages
- ⏱️ **Page Load Waiting**: Wait for complete page load with dynamic content
- 🎛️ **JavaScript Strategies**: Stealth, standard, and no-JS options
- 🛡️ **Error Handling**: Comprehensive exception handling with specific error types
- 📊 **Logging**: Built-in logging support for debugging and monitoring
- 🎯 **Simple Interface**: GET-only requests for clean and focused API
- 🚀 **High Performance**: Optimized for speed and reliability
- 📦 **Zero Dependencies**: Only requires the standard `requests` library

## Installation

```bash
pip install askpablos-api
```

## Development

### Setting up for Development

```bash
git clone https://github.com/fawadss1/askpablos_api.git
cd askpablos-api
pip install -e ".[dev]"
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Support

For support and questions:

- **Email**: fawadstar6@gmail.com
- **Documentation**: [https://askpablos-api.readthedocs.io/](https://askpablos-api.readthedocs.io/)
- **Issues**: Please report bugs and feature requests at [GitHub Issues](https://github.com/fawadss1/askpablos_api/issues)

## Changelog

### v0.2.0 (Current)

- Initial release
- HMAC-SHA256 authentication
- GET request support through proxy service
- Comprehensive error handling
- Built-in logging support
- Browser integration for JavaScript-heavy sites
