---
title: "Enrich stores"
method: POST
path: "/stores/enrich"
tags: ["stores"]
---

# Enrich stores

`POST /stores/enrich`

## Request

- Base URL: `https://storeinspect.com/api/v1`
- URL: `https://storeinspect.com/api/v1/stores/enrich`
- Auth: HTTP bearer

Batch enriches a small set of known Shopify store domains already present in the StoreInspect database. Returned stores consume the unique-store export allowance once per allowance period.

## Request body

- StoreEnrichRequest
  - `domains` string[], required: Store domains or URLs to enrich. Inputs are normalized to hostnames.
  - `include` string[]
  - `contact_roles` string[]
  - `max_contacts_per_store` integer
  - `reveal_contacts` boolean: Must be false in V1 synchronous enrichment. Use /api/v1/contacts/reveal to reveal contacts.

## Response `200`

Found and not-found rows for a small set of domains already present in the StoreInspect database.

- StoreEnrichResponse
  - `object` 'store_enrichment_result', required
  - `data` StoreEnrichResult[], required
    - `domain` string, required
    - `status` 'found' | 'not_found', required
    - `store` Store, required
      - `id` string
      - `object` 'store'
      - `domain` string
      - `name` string
      - `category` string, nullable
      - `country` string, nullable
      - `traffic_tier` string, nullable
      - `revenue_tier` string, nullable
      - `shopify_plus` boolean
      - `lead_fit_score` number, nullable
      - `store_created_at` object, nullable
        - `estimate` string, date-time, nullable
        - `resolution` 'exact' | 'month' | 'year' | 'null', nullable
        - `source` string, nullable
        - `confidence` 'high' | 'medium' | 'low' | 'null', nullable
      - `first_discovered_at` string, date-time, nullable
      - `technologies` object
        - `apps` string[]
        - `pixels` string[]
        - `theme` object
          - `name` string, nullable
          - `type` string, nullable
          - `version` string, nullable: Shopify.theme schema_version, as published by the theme.
          - `theme_store_id` integer, nullable: Shopify Theme Store id; null for custom themes.
          - `outdated` boolean, nullable: true for vintage Shopify themes or Dawn-family themes two or more major versions behind; false for current Dawn-family themes; null when no rule applies.
      - `ios_app` object, nullable: The store's own iOS app, from its Smart App Banner or a single App Store link on the homepage.
        - `app_id` string
        - `url` string, uri
      - `checkout` object: From the store's public /meta.json. null means not checked yet.
        - `ships_to_countries` string[], nullable: ISO 3166-1 alpha-2 codes; "*" is Shopify's rest-of-world shipping zone.
        - `offers_shop_pay_installments` boolean, nullable
        - `shopify_pay_enabled_card_brands` string[], nullable
      - `contacts_summary` object
        - `total` integer
        - `has_revealable_contacts` boolean
        - `verified_email_count` integer
        - `roles` string[]
    - `contact_previews` ContactPreview[]
      - `id` string
      - `object` 'contact_preview'
      - `first_name` string, nullable
      - `last_name_obfuscated` string, nullable
      - `role` string, nullable
      - `seniority` 'executive' | 'decision_maker' | 'other'
      - `title` string, nullable
      - `has_verified_email` boolean
      - `has_phone` boolean
      - `has_linkedin` boolean
      - `revealed` boolean
      - `store` object
        - `id` string
        - `domain` string
        - `name` string
        - `category` string, nullable
        - `traffic_tier` string, nullable
        - `technologies` object
          - `apps` string[]
          - `pixels` string[]
  - `found` integer, required
  - `not_found` integer, required
  - `request_id` string, required

## Other responses

- `400`: Invalid domains or unsupported reveal mode.
- `401`: Missing or invalid API key.
- `403`: The account does not have API access.

---

[API](https://skmtc.dev/storeinspect/apis/storeinspect-api.md) · [All operations](https://skmtc.dev/storeinspect/apis/storeinspect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/storeinspect/apis/storeinspect-api/revisions/e9477dd90cf9?raw)