ScraperCity logo

Ecommerce Store Database API API Documentation

Ecommerce Store Database API

Query the ecommerce store database via API. Access millions of stores with revenue, traffic, employee, and contact data. Requires $649/mo plan.

Included with $649/mo planGET /api/v1/database/ecommerce

Database APIs are included with the $649/mo plan.

Parameters

NameTypeRequiredDescription
pagenumberOptionalPage number (default: 1)Default: 1Example: 1
limitnumberOptionalResults per page (max: 100)Default: 50Example: 100
platformstring[]OptionalFilter by ecommerce platform (multiple allowed)Example: Shopify
countrystring[]OptionalFilter by country code (multiple allowed)Example: US
statestringOptionalFilter by state (partial match)Example: California
citystringOptionalFilter by city (partial match)Example: Los Angeles
categorystring[]OptionalFilter by store category (multiple allowed)Example: Apparel
merchantstringOptionalFilter by merchant name (partial match)Example: Nike
domainstringOptionalFilter by domain (partial match)Example: nike.com
technologiesstring[]OptionalFilter by technology stack (multiple allowed)Example: Klaviyo
salesMinnumberOptionalMinimum monthly revenueExample: 100000
salesMaxnumberOptionalMaximum monthly revenueExample: 10000000
visitsMinnumberOptionalMinimum monthly visitsExample: 50000
visitsMaxnumberOptionalMaximum monthly visitsExample: 5000000
employeesMinnumberOptionalMinimum employee countExample: 10
employeesMaxnumberOptionalMaximum employee countExample: 500
hasEmailbooleanOptionalOnly return stores with email addressesDefault: falseExample: true
hasPhonebooleanOptionalOnly return stores with phone numbersDefault: falseExample: true
hasInstagrambooleanOptionalOnly return stores with InstagramDefault: falseExample: true
hasFacebookbooleanOptionalOnly return stores with FacebookDefault: falseExample: true
hasTiktokbooleanOptionalOnly return stores with TikTokDefault: falseExample: true

Examples

Find Shopify stores with 500K+ monthly revenue

curl "https://app.scrapercity.com/api/v1/database/ecommerce?platform=Shopify&salesMin=500000&hasEmail=true&limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search for stores using Klaviyo in the US

curl "https://app.scrapercity.com/api/v1/database/ecommerce?technologies=Klaviyo&country=US&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Find high-traffic apparel stores

curl "https://app.scrapercity.com/api/v1/database/ecommerce?category=Apparel&visitsMin=100000&employeesMin=10&limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

Use Cases

  • Build targeted outreach lists for ecommerce brands
  • Identify potential clients by technology stack
  • Analyze competitor landscapes by category and revenue
  • Feed ecommerce data into your CRM or analytics pipeline

Best Practices

  • Use revenue and employee filters to target the right size stores
  • Rate limit: 100 stores per request, 100,000 stores per day
  • Combine platform + category + location for precise targeting
  • Use technologies filter to find stores using specific tools (Klaviyo, Shopify Plus, etc.)
  • Requires $649/mo plan - upgrade at /dashboard/billing
  • Daily limit resets at midnight UTC

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.