Python API wrapper for DarkSearch (darksearch.io).
Project description
DarkSearch
Python API wrapper for DarkSearch (darksearch.io).
Install
pip install darksearch
Cli
darksearch --query "query" --page 1
darksearch --query "query" --pages 2
darksearch --query "query" --pages 2 --wait 2
darksearch --query "query" --json
Usage
import darksearch
"""
`timeout`, `headers`, and `proxies` are optional
timeout = 10
proxies = {
"http": "http://127.0.0.1:8080"
}
headers = {
"User-Agent": "Chrome/57.0.2987.133"
}
"""
client = darksearch.Client(timeout=30, headers=None, proxies=None)
results = client.search("query")
"""
`results` is a JSON dict object like this
{
"total": int,
"per_page": int,
"current_page": int,
"last_page": int,
"from": int,
"to": int,
"data": [
{
"title": string,
"link": string,
"description": string
}
]
}
"""
results = client.search("query", page=2)
"""
`results` is a JSON dict object like this
{
"total": int,
"per_page": int,
"current_page": 2,
"last_page": int,
"from": int,
"to": int,
"data": [
{
"title": string,
"link": string,
"description": string
}
]
}
"""
results = client.search("query", pages=2)
"""
`results` is a list of JSON dict objects like this
[
{
"total": int,
"per_page": int,
"current_page": 1,
"last_page": int,
"from": int,
"to": int,
"data": [
{
"title": string,
"link": string,
"description": string
}
]
},
...
]
"""
results = client.search("query", pages=2, wait=2)
"""
`wait` is the seconds between requests (DarkSearch's API is limited to 30 requests per minute.)
`results` is a list of JSON dict objects
[
{
"total": int,
"per_page": int,
"current_page": 1,
"last_page": int,
"from": int,
"to": int,
"data": [
{
"title": string,
"link": string,
"description": string
}
]
},
...
]
"""
crawling_status = darksearch.crawling_status()
"""
`crawling_status` is a integer of pages that have been indexed
"""
Testing
pytest
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
darksearch-2.1.0.tar.gz
(5.7 kB
view hashes)
Built Distribution
Close
Hashes for darksearch-2.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c4a8f6a69a546fb5f58a689839928a76920f50d224342cb7465c0eb67da2a3c0 |
|
MD5 | 00bf5b1cc2ebec0b776d6a2e8fa6bb68 |
|
BLAKE2b-256 | bf3157a7a03fee9b2a339c6273b8f240979cac5318ec20bb9bb79b2e66595b31 |