Shopify & Ecommerce Store Finder — Python SDK

Python client for the Shopify & Ecommerce Store Finder Apify Actor. Send public Actor inputs, wait for the hosted run, and receive clean Dataset rows without maintaining scraping infrastructure.

Results

• Platform and country targeting
• Public emails, phones and social profiles
• Firmographic and technology fields
• Sorting, pagination and count-only queries

The repository exposes only the Actor's public input and output contract. Dataset selection and processing remain inside the hosted Actor.

Install

pip install git+https://github.com/apivault-labs/website-leads-database-python.git

Create an Apify token at Console → Integrations, then:

from website_leads_database import WebsiteLeadsDatabaseClient

client = WebsiteLeadsDatabaseClient(api_token="apify_api_xxxxxx")
rows = client.run({'platforms': ['shopify_sites', 'woocommerce_sites'],
 'country': ['US'],
 'hasEmail': True,
 'dedupeByDomain': True,
 'outputPreset': 'contacts',
 'maxItems': 50})
print(rows[0] if rows else "No results")

You can set APIFY_API_TOKEN instead of passing the token in code.

Public input options

The complete, versioned schema is also available on the Actor page.

Pricing

Pay per delivered result through Apify, starting around $8/1,000 results on paid tiers. Free-plan pricing and platform usage can differ; check the Actor page before large runs.

Examples

• examples/count_segment.py — inspect audience size before export
• examples/sample_50.py — review a safe 50-row sample
• examples/export_contacts.py — save Shopify contacts to CSV
• examples/traffic_qualified_export.py — prioritize stores by audience size
• examples/resume_next_page.py — continue with the Actor-provided next-page input
• examples/quickstart.py — minimal first run
• 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

Use client.count(...) before a large request. Use client.run_page(...) when you need the copy-ready continuation returned by the hosted Actor.

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.