Validate Shopify Store - The Search Company API

Getting Started

Website

Onboarding

Cron

Your Current Setup

Explore

Settings - Toggle

Settings - Business

Settings - Team

Settings - Billing

Settings - Domain

Webhooks

Health

Manual Trigger

curl -X POST "https://searchcompany-main.up.railway.app/api/onboarding/validate-shopify" \
  -H "Content-Type: application/json" \
  -d '{"url": "gymshark.com"}'

{
  "is_shopify": true,
  "message": "Valid Shopify store"
}

{
  "is_shopify": false,
  "message": "This does not appear to be a Shopify store"
}

POST

api

onboarding

validate-shopify

curl -X POST "https://searchcompany-main.up.railway.app/api/onboarding/validate-shopify" \
  -H "Content-Type: application/json" \
  -d '{"url": "gymshark.com"}'

{
  "is_shopify": true,
  "message": "Valid Shopify store"
}

{
  "is_shopify": false,
  "message": "This does not appear to be a Shopify store"
}

Public endpoint used during onboarding to validate that a user’s website is a Shopify store we can support. This prevents non-Shopify stores from signing up.

This is a public endpoint - no authentication required. Rate limited to 5 requests/minute per IP.

How It Works

The endpoint checks if the domain has an accessible /products.json endpoint, which is a Shopify-specific API that every standard Shopify store exposes. Why /products.json?

Every Shopify store has this endpoint
Returns 200 for Shopify stores, 404 for non-Shopify sites
If blocked (403), the store is using a headless setup we can’t support

Request Body

string

required

Website URL to validate (e.g., “gymshark.com” or “https://www.allbirds.com”)

Response

boolean

true if the URL is a supported Shopify store, false otherwise

string

Human-readable status message

Supported vs Unsupported Stores

Store Type	/products.json	Supported?
Standard Shopify	200 ✅	Yes
Shopify behind Cloudflare	200 ✅	Yes
Headless (custom frontend)	403/404 ❌	No
Non-Shopify	404 ❌	No

curl -X POST "https://searchcompany-main.up.railway.app/api/onboarding/validate-shopify" \
  -H "Content-Type: application/json" \
  -d '{"url": "gymshark.com"}'

{
  "is_shopify": true,
  "message": "Valid Shopify store"
}

{
  "is_shopify": false,
  "message": "This does not appear to be a Shopify store"
}

Usage in Onboarding

const response = await fetch(
  "https://searchcompany-main.up.railway.app/api/onboarding/validate-shopify",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ url: userInput }),
  }
);
const { is_shopify, message } = await response.json();

if (!is_shopify) {
  showError("This does not appear to be a Shopify store");
  return;
}

// Proceed with onboarding...

​How It Works

​Request Body

​Response

​Supported vs Unsupported Stores

​Usage in Onboarding

How It Works

Request Body

Response

Supported vs Unsupported Stores

Usage in Onboarding