StoreCensus

StoreCensus API Documentation

v1Base URL: https://api.storecensus.com

The StoreCensus API gives you direct access to a constantly updated database of millions of Shopify stores. Instantly retrieve detailed e-commerce data, including store metadata, contact information, installed apps, traffic insights, revenue estimates, and more. Whether you're building outreach tools, enriching CRM records, or powering custom dashboards, the StoreCensus API is designed for high-volume, fast-filtering use cases that demand accuracy and scale.

Introduction

Our API allows you to programmatically retrieve detailed information about online stores including:

  • Basic business information (location, country, vertical, language, currency)
  • Contact details (emails, phone numbers)
  • Social media presence across platforms
  • Business metrics (revenue, employee count, technology spend)
  • Product data (pricing, inventory counts)
  • Technical analysis (SEO, tracking pixels, conversion optimization)
  • App integrations and reviews

This API is designed for developers, marketers, and e-commerce professionals who need reliable data about online stores for lead generation, market research, competitive analysis, and more.

Authentication

The StoreCensus API uses Bearer Token Authentication. You must include your API key in the Authorization header of all requests.

Authentication Method

Authorization: Bearer your.api.key

API keys can be generated on the API page of your StoreCensus account after logging in.

Authentication Errors

Status CodeErrorDescription
401{'error': 'Missing API key'}No API key was provided in the request
401{'error': 'Invalid Authorization header format. Expected: Bearer your.api.key'}The Authorization header format is incorrect
401{'error': 'API key cannot be empty'}An empty API key was provided
401{'error': 'Invalid API key or inactive subscription'}The API key is invalid or the subscription is not active

Rate Limits

The StoreCensus API implements rate limiting based on your subscription plan. Rate limits are applied on a per-API-key basis.

Rate Limit Plans

PlanRate Limit
Other Plans6 requests per second
Premium Plan30 requests per second

Rate Limit Implementation

  • Rate limits are calculated using a 1-second sliding window
  • When rate limits are exceeded, the API returns a 429 Too Many Requests response
  • The response includes a Retry-After header indicating when you can make another request
  • Rate limit implementation uses in-memory caching for optimal performance

Rate Limit Exceeded Response:

{'error': 'Rate limit exceeded'}

Error Handling

The StoreCensus API uses standard HTTP status codes to indicate the success or failure of requests. All errors are returned in a consistent JSON format.

Status CodeDescription
400 Bad RequestThe request was malformed or missing required parameters
401 UnauthorizedAuthentication failed or was not provided
429 Too Many RequestsRate limit exceeded
500 Internal Server ErrorAn error occurred on the server

Error Response Format

All errors are returned in a consistent JSON format with an error field containing a description of the error:

{'error': 'Description of the error'}

The /domain Endpoint

Endpoint Details

URLGET /api/v1/domain/{domain}
DescriptionRetrieve comprehensive e-commerce intelligence data for a specific domain
AuthenticationRequired (Bearer token)
Rate LimitedYes (based on subscription plan)

Path Parameters

ParameterDescription
domainrequiredThe domain name to analyze (e.g., "example-store.com")

Request Example

curl -X GET "https://api.storecensus.com/api/v1/domain/example-store.com" \
  -H "Authorization: Bearer your.api.key" \
  -H "Content-Type: application/json"

Response Format

The API returns organized domain data in the following structure:

{
  "data": [
    {
      "basic_information": {
        "lead_id": "string",
        "location_on_site": "string",
        "country": "string",
        "store_vertical": "string",
        "language": "string",
        "theme": "string",
        "currency": "string",
        "website_created_at": "timestamp",
        "password_protected": boolean,
        "employees": number
      },
      "contact_information": {
        "emails": ["email1@domain.com", "email2@domain.com"],
        "telephones": ["cleaned phone numbers"]
      },
      "social_media": {
        "facebook": "url",
        "instagram": "url",
        "twitter": "url",
        "linkedin": "url",
        "pinterest": "url",
        "youtube": "url",
        "tiktok": "url",
        "snapchat": "url"
      },
      "business_metrics": {
        "sales_revenue": number,
        "technology_spend": number,
        "employees": number,
        "company": "string"
      },
      "product_data": {
        "average_product_price": number,
        "product_page_count": number,
        "variant_count": number
      },
      "app_information": {
        "apps": ["app1", "app2", "app3"]
      },
      "review_fields": {
        "reviews": "review data"
      },
      "ecommerce_analysis": {
        "has_lead_capture": boolean,
        "has_meta_description": boolean,
        "robots_meta_tag": "string",
        "structured_data": boolean,
        "favicon": boolean,
        "blog": boolean,
        "using_default_theme": boolean,
        "has_custom_fonts": boolean,
        "custom_favicon": boolean,
        "accessibility": boolean,
        "generic_about_us": boolean,
        "email_marketing_tools": boolean,
        "visible_email_signup": boolean,
        "broken_signup_form": boolean,
        "ga4": boolean,
        "meta_pixel": boolean,
        "pinterest_pixel": boolean,
        "snapchat_pixel": boolean,
        "tiktok_pixel": boolean,
        "twitter_pixel": boolean,
        "quora_pixel": boolean,
        "reddit_pixel": boolean,
        "microsoft_ads": boolean,
        "tag_manager": boolean,
        "tracking_scripts_errors": boolean,
        "ab_testing_tools": boolean,
        "heatmap_tools": boolean,
        "language_selector": boolean,
        "currency_converter": boolean,
        "broken_multilingual_plugin": boolean,
        "shipping_currency_local": boolean,
        "lazy_loading": boolean,
        "has_ads": boolean,
        "abonded_cart_recovery": boolean,
        "loyalty_program": boolean,
        "exit_intent_popups": boolean,
        "mobile_specific_features": boolean,
        "responsive": boolean,
        "reviews_feature": boolean,
        "trust_badges": boolean,
        "user_generated_content": boolean,
        "social_sharing_buttons": boolean,
        "product_customization": boolean,
        "product_filtering": boolean,
        "upsells_cross_sells": boolean,
        "b2b_features": boolean,
        "has_dropshipping_indicators": boolean,
        "low_store_maturity": boolean,
        "affiliate_program": boolean,
        "live_chat_widget": boolean,
        "faq_widget": boolean,
        "size_guides": boolean
      },
      "system_fields": {
        "last_check": "timestamp"
      }
    }
  ]
}

Example Response

{
  "data": [
    {
      "basic_information": {
        "lead_id": "12345",
        "country": "United States",
        "store_vertical": "Fashion",
        "language": "en",
        "currency": "USD",
        "employees": 25
      },
      "contact_information": {
        "emails": ["contact@example-store.com", "support@example-store.com"],
        "telephones": ["+1-555-123-4567"]
      },
      "social_media": {
        "facebook": "https://facebook.com/examplestore",
        "instagram": "https://instagram.com/examplestore",
        "twitter": "https://twitter.com/examplestore"
      },
      "business_metrics": {
        "sales_revenue": 1500000,
        "technology_spend": 50000,
        "employees": 25
      },
      "product_data": {
        "average_product_price": 89.99,
        "product_page_count": 450,
        "variant_count": 1200
      },
      "ecommerce_analysis": {
        "has_lead_capture": true,
        "ga4": true,
        "meta_pixel": true,
        "responsive": true,
        "reviews_feature": true,
        "live_chat_widget": true
      },
      "system_fields": {
        "last_check": "2025-01-15T10:30:00Z"
      }
    }
  ]
}

Empty Response

When no data is found for a domain:

{'data': []}