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,
 'maxItems': 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

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/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.