Website Traffic Database — Python SDK
Python client for the Website Traffic Database Apify Actor. Send public Actor inputs, wait for the hosted run, and receive clean Dataset rows without maintaining scraping infrastructure.
Results
- Traffic and rank filters
- Country and category discovery
- Growth and engagement signals
- Direct domain and similar-site workflows
Traffic values are estimates. The wrapper exposes only the Actor's public contract; processing remains inside the hosted Actor.
Install
pip install git+https://github.com/apivault-labs/website-traffic-database-python.git
Create an Apify token at Console → Integrations, then:
from website_traffic_database import WebsiteTrafficDatabaseClient
client = WebsiteTrafficDatabaseClient(api_token="apify_api_xxxxxx")
rows = client.run({'workflow': 'auto',
'country': 'US',
'minVisits': 10000,
'onlyGrowing': True,
'maxResults': 100})
print(rows[0] if rows else "No results")
You can set APIFY_API_TOKEN instead of passing the token in code.
Public input options
| Field | Type | Default | Description |
|---|---|---|---|
workflow |
string |
auto |
Discover websites, inspect domains or find similar sites. |
minVisits |
integer |
0 |
Minimum estimated monthly visits. |
maxVisits |
integer |
0 |
Optional maximum estimated monthly visits. |
category |
string |
`` | Website category filter. |
country |
string |
`` | ISO-2 country code. |
hasAiTraffic |
boolean |
False |
Keep sites with detected AI referral traffic. |
onlyGrowing |
boolean |
False |
Keep sites with positive traffic growth. |
minGrowthPercent |
number |
0 |
Minimum growth percentage. |
keyword |
string |
`` | Match a domain or site name. |
trafficSource |
string |
`` | Traffic source to filter by. |
maxBounce |
number |
0 |
Optional maximum bounce rate. |
minPagesPerVisit |
number |
0 |
Minimum pages per visit. |
maxResults |
integer |
100 |
Maximum number of returned rows. |
sortBy |
string |
visits |
Public field used to order results. |
sortOrder |
string |
desc |
Ascending or descending order. |
outputPreset |
string |
outreach |
Choose a public result layout. |
domains |
array |
[] |
Domains to inspect directly. |
similarTo |
string |
`` | Domain used to discover similar websites. |
The complete, versioned schema is also available on the Actor page.
Pricing
Pay per delivered result through Apify, starting around $7/1,000 results on paid tiers. Free-plan pricing and platform usage can differ; check the Actor page before large runs.
Examples
examples/quickstart.py— first runexamples/bulk_analysis.py— expand a target listexamples/export_csv.py— save flat result fieldsexamples/save_json.py— preserve nested outputexamples/cost_estimate.py— estimate result-event chargesexamples/environment_token.py— keep credentials out of code
Architecture and privacy
This repository is intentionally a thin API client. Collection, retries, analysis and billing run inside the hosted Apify Actor. No private implementation, credentials, scoring weights or infrastructure configuration are included.
License
MIT. The hosted Actor is a separate paid service governed by Apify terms.
Release files for website-traffic-database 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| website_traffic_database-0.1.0.tar.gz | 5.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| website_traffic_database-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.7 kB
Release files / website_traffic_database-0.1.0.tar.gz
| Download URL | website_traffic_database-0.1.0.tar.gz |
|---|---|
| Size | 5.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ffd3ff28ae2e9a9e2fdb6e066ed96e950b953226e82d290bb2f38cb08d0da2c0
|
|
BLAKE2b-256 checksum How to use checksums |
842fd5ce876123706d606ab8689eff361c014765d248a9630fd6e3d26d419cf5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / website_traffic_database-0.1.0-py3-none-any.whl
| Download URL | website_traffic_database-0.1.0-py3-none-any.whl |
|---|---|
| Size | 6.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
16099492261975ae3078d8f6e0710adfeded5f88523b9527d0bb5f2305226828
|
|
BLAKE2b-256 checksum How to use checksums |
8b409aa07ecb64c15c0acc5558e48288f523963849e4c006fb5e4d923acca690
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|