thordata-sdk 0.2.4__py3-none-any.whl → 0.3.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- thordata/__init__.py +16 -0
- {thordata_sdk → thordata}/async_client.py +67 -33
- thordata/client.py +486 -0
- thordata/enums.py +25 -0
- thordata/parameters.py +52 -0
- thordata_sdk-0.3.1.dist-info/METADATA +200 -0
- thordata_sdk-0.3.1.dist-info/RECORD +10 -0
- {thordata_sdk-0.2.4.dist-info → thordata_sdk-0.3.1.dist-info}/WHEEL +1 -1
- thordata_sdk-0.3.1.dist-info/top_level.txt +1 -0
- thordata_sdk/__init__.py +0 -9
- thordata_sdk/client.py +0 -303
- thordata_sdk/enums.py +0 -20
- thordata_sdk/parameters.py +0 -41
- thordata_sdk-0.2.4.dist-info/METADATA +0 -113
- thordata_sdk-0.2.4.dist-info/RECORD +0 -10
- thordata_sdk-0.2.4.dist-info/top_level.txt +0 -1
- {thordata_sdk-0.2.4.dist-info → thordata_sdk-0.3.1.dist-info/licenses}/LICENSE +0 -0
|
@@ -1,113 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.1
|
|
2
|
-
Name: thordata-sdk
|
|
3
|
-
Version: 0.2.4
|
|
4
|
-
Summary: The official Python SDK for Thordata Proxy & Scraper Infrastructure.
|
|
5
|
-
Home-page: https://github.com/Thordata/thordata-python-sdk
|
|
6
|
-
Author: Thordata Developer Team
|
|
7
|
-
Author-email: support@thordata.com
|
|
8
|
-
License: Apache License 2.0
|
|
9
|
-
Project-URL: Bug Tracker, https://github.com/Thordata/thordata-python-sdk/issues
|
|
10
|
-
Project-URL: Documentation, https://github.com/Thordata/thordata-python-sdk#readme
|
|
11
|
-
Classifier: Development Status :: 4 - Beta
|
|
12
|
-
Classifier: Intended Audience :: Developers
|
|
13
|
-
Classifier: Programming Language :: Python :: 3
|
|
14
|
-
Classifier: Programming Language :: Python :: 3.8
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
-
Classifier: License :: OSI Approved :: Apache Software License
|
|
19
|
-
Classifier: Operating System :: OS Independent
|
|
20
|
-
Classifier: Topic :: Internet :: WWW/HTTP
|
|
21
|
-
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
22
|
-
Requires-Python: >=3.8
|
|
23
|
-
Description-Content-Type: text/markdown
|
|
24
|
-
License-File: LICENSE
|
|
25
|
-
Requires-Dist: requests>=2.25.0
|
|
26
|
-
Requires-Dist: aiohttp>=3.8.0
|
|
27
|
-
|
|
28
|
-
# Thordata Python SDK
|
|
29
|
-
|
|
30
|
-
<h4 align="center">
|
|
31
|
-
The Official Python Client for the Thordata Proxy Network & Web Scraper API.
|
|
32
|
-
<br>
|
|
33
|
-
<i>High-performance, async-ready, designed for AI Agents and large-scale data collection.</i>
|
|
34
|
-
</h4>
|
|
35
|
-
|
|
36
|
-
<p align="center">
|
|
37
|
-
<a href="https://pypi.org/project/thordata-sdk/"><img src="https://img.shields.io/pypi/v/thordata-sdk?color=blue" alt="PyPI version"></a>
|
|
38
|
-
<a href="https://github.com/Thordata/thordata-python-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License"></a>
|
|
39
|
-
<a href="https://python.org"><img src="https://img.shields.io/badge/python-3.8+-blue" alt="Python Versions"></a>
|
|
40
|
-
</p>
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
## 🛠 Installation
|
|
45
|
-
|
|
46
|
-
Install via pip:
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
pip install thordata-sdk
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
## ⚡ Quick Start
|
|
53
|
-
|
|
54
|
-
### 1. Proxy Usage (Simple GET Request)
|
|
55
|
-
|
|
56
|
-
**Python**
|
|
57
|
-
|
|
58
|
-
```python
|
|
59
|
-
from thordata_sdk import ThordataClient
|
|
60
|
-
|
|
61
|
-
# Initialize with your credentials from the Thordata Dashboard
|
|
62
|
-
client = ThordataClient(
|
|
63
|
-
scraper_token="YOUR_SCRAPER_TOKEN", # From "Scraping Tool Token"
|
|
64
|
-
public_token="YOUR_PUBLIC_TOKEN", # From "Public API"
|
|
65
|
-
public_key="YOUR_PUBLIC_KEY" # From "Public API"
|
|
66
|
-
)
|
|
67
|
-
|
|
68
|
-
# Send a request through the proxy
|
|
69
|
-
response = client.get("http://httpbin.org/ip")
|
|
70
|
-
print(response.json())
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
### 2. Real-time SERP Search
|
|
74
|
-
|
|
75
|
-
**Python**
|
|
76
|
-
|
|
77
|
-
```python
|
|
78
|
-
results = client.serp_search("Thordata technology", engine="google")
|
|
79
|
-
print(f"Results found: {len(results.get('organic', []))}")
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
### 3. Asynchronous Usage (High Concurrency)
|
|
83
|
-
|
|
84
|
-
**Python**
|
|
85
|
-
|
|
86
|
-
```python
|
|
87
|
-
import asyncio
|
|
88
|
-
from thordata_sdk import AsyncThordataClient
|
|
89
|
-
|
|
90
|
-
async def main():
|
|
91
|
-
async with AsyncThordataClient(scraper_token="...", public_token="...", public_key="...") as client:
|
|
92
|
-
response = await client.get("http://httpbin.org/ip")
|
|
93
|
-
print(await response.json())
|
|
94
|
-
|
|
95
|
-
asyncio.run(main())
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
## ⚙️ Features Status
|
|
99
|
-
|
|
100
|
-
| Feature | Status | Description |
|
|
101
|
-
|---------|--------|-------------|
|
|
102
|
-
| Proxy Network | ✅ Stable | Synchronous & Asynchronous support via aiohttp. |
|
|
103
|
-
| SERP API | ✅ Stable | Real-time Google/Bing/Yandex search results. |
|
|
104
|
-
| Web Scraper | ✅ Stable | Async task management for scraping complex sites (e.g., YouTube). |
|
|
105
|
-
| Authentication | ✅ Secure | Dual-token system for enhanced security. |
|
|
106
|
-
|
|
107
|
-
## 📄 License
|
|
108
|
-
|
|
109
|
-
This project is licensed under the Apache License 2.0.
|
|
110
|
-
|
|
111
|
-
## 📞 Support
|
|
112
|
-
|
|
113
|
-
For technical assistance, please contact support@thordata.com or verify your tokens in the Thordata Dashboard.
|
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
thordata_sdk/__init__.py,sha256=TpVRMWiWSkxq6MUoX1LCkfmuZTH9FWC65JbaALeVoVY,268
|
|
2
|
-
thordata_sdk/async_client.py,sha256=YIIKddghCzGAvrx2Bqy8XkGcgFLbCPgzkQw-jcq2WH8,8612
|
|
3
|
-
thordata_sdk/client.py,sha256=UyRLjRFKep2SLOWExjAJ5EB0ED0BUiBlfWGwts3sykw,10372
|
|
4
|
-
thordata_sdk/enums.py,sha256=gKpaqV-_OO7w1LCg9PTuSUiJJq_q4ad5k6f88UlTPQw,639
|
|
5
|
-
thordata_sdk/parameters.py,sha256=3ck0XP0lZaUYs4eEZoLLo6zDTClRRrLO9TlggesMmwI,1384
|
|
6
|
-
thordata_sdk-0.2.4.dist-info/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
|
|
7
|
-
thordata_sdk-0.2.4.dist-info/METADATA,sha256=mluyngNHvMXlRfAgA4F7JHC6Sc1f0z4cuut3CI42yow,3734
|
|
8
|
-
thordata_sdk-0.2.4.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
|
|
9
|
-
thordata_sdk-0.2.4.dist-info/top_level.txt,sha256=0b2NvIf8zEcLXLF0alJAeurAEeB-2e9qh72bLukM6zI,13
|
|
10
|
-
thordata_sdk-0.2.4.dist-info/RECORD,,
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
thordata_sdk
|
|
File without changes
|