Skip to main content

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.

Apify Actor Python 3.9+ License: MIT

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 run
  • examples/bulk_analysis.py — expand a target list
  • examples/export_csv.py — save flat result fields
  • examples/save_json.py — preserve nested output
  • examples/cost_estimate.py — estimate result-event charges
  • examples/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)

Source distribution for website-traffic-database 0.1.0
File Size Uploaded
website_traffic_database-0.1.0.tar.gz 5.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for website-traffic-database 0.1.0
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page