# Squarespace Detector | Websites & Store Signals (`keystonelabs/squarespace-site-detector`) Actor

Detect exposed Squarespace and Squarespace Commerce signals from supplied websites. Export matches, ecommerce and analytics fields for migration research. Public HTML and headers only; no complete-stack guarantee.

- **URL**: https://apify.com/keystonelabs/squarespace-site-detector.md
- **Developed by:** [Nick McNemar](https://apify.com/keystonelabs) (community)
- **Categories:** Lead generation, SEO tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 website checkeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### Find Squarespace sites in a website list

Squarespace Detector: Detect exposed Squarespace and Squarespace Commerce signals from supplied websites. Export matches, ecommerce and analytics fields for migration research. Public HTML and headers only; no complete-stack guarantee.

### Start with a small example

1. Open Input, switch to JSON and paste the example below. Replace the example startUrls with your own research targets when ready.
2. Check the live Pricing tab and set a run spending limit.
3. Run the Actor, then open the **Workflow** output view. Inspect `url`, `matchesFilter`, `cms`, `ecommerce`, `analytics`, `error`.
4. Export JSON for nested data or CSV for a spreadsheet. Review a small sample before increasing the scope.

```json
{
  "startUrls": [
    "https://www.squarespace.com",
    "https://www.sadiebarnette.com",
    "https://wordpress.org"
  ],
  "filterTechnologies": [
    "Squarespace",
    "Squarespace Commerce"
  ],
  "onlyMatching": false
}
```

At the rate checked September 9, 2026, 3 saved rows cost $0.009 in Actor event fees ($3.00 per 1,000 rows). Actual returned rows determine the event fee. Taxes and other account services may be separate.

### What can I use it for?

- **Agency and designer prospecting.** Small businesses on Squarespace are the classic customers for design refreshes, SEO, photography and content services.
- **Selling Squarespace extensions and templates.** Turn any domain list into the subset running the platform your product plugs into.
- **Migration targeting in both directions.** Find Squarespace stores that have outgrown Squarespace Commerce, or exclude Squarespace matches to find sites on other builders.
- **Market research.** Measure Squarespace's share against Wix, Webflow and WordPress across an industry, a city or a directory of local businesses.
- **Enriching your data.** Add an `isSquarespace` column and the surrounding stack to a spreadsheet of accounts in one run.

### What data does it return?

One record per website:

| Field | Meaning |
|---|---|
| `url`, `finalUrl`, `statusCode`, `title` | What you asked for, where it resolved to, and the page title |
| `matchesFilter` | `true` when the site runs any of the signals you listed under **Signals to look for** |
| `matchedTechnologies` | Which signals were found, e.g. `["Squarespace", "Squarespace Commerce"]` |
| `cms` | `Squarespace` for a match, or whatever else the site runs |
| `ecommerce` | `Squarespace Commerce` when a store is present |
| `analytics`, `tagManager`, `advertising` | Google Analytics, GTM, Meta Pixel and others |
| `paymentProcessors` | Stripe, PayPal, Afterpay and similar where visible |
| `marketingAutomation`, `liveChat` | Mailchimp, HubSpot, Tidio and similar where loaded directly |
| `technologyCount` | Total technologies detected |
| `technologies` | The complete list with categories, versions and confidence scores |
| `error` | `null` on success, otherwise why the site could not be checked |

Sites that time out or refuse the connection are still returned with an `error`, so input and output line up one to one.

#### Illustrative output

Values explain the output shape; they are not a live result or guaranteed field coverage.

```json
{
  "url": "https://www.sadiebarnette.com",
  "finalUrl": "https://www.sadiebarnette.com/",
  "statusCode": 200,
  "title": "Sadie Barnette",
  "matchesFilter": true,
  "matchedTechnologies": ["Squarespace", "Squarespace Commerce"],
  "cms": "Squarespace",
  "ecommerce": "Squarespace Commerce",
  "technologyCount": 4,
  "technologies": [
    { "name": "Squarespace", "categories": ["CMS", "Page builders"], "version": null, "confidence": 100, "website": "https://www.squarespace.com" },
    { "name": "Squarespace Commerce", "categories": ["Ecommerce"], "version": null, "confidence": 100, "website": "https://www.squarespace.com/ecommerce-website" }
  ],
  "error": null
}
```

### How to use it

1. Paste your domains under **Websites to check**, upload a file, or pass them through the API as `startUrls`. Bare domains like `example.com` are fine.
2. Leave **Signals to look for** at its defaults to catch both Squarespace sites and Squarespace Commerce stores, or trim it to `Squarespace Commerce` to find stores only.
3. Switch on **Store only matching websites** to pay only for the Squarespace sites and discard the rest.
4. Click **Start** and download the results as JSON, CSV or Excel from the **Output** tab, or read them from the dataset via the API.

#### Input example

```json
{
  "startUrls": [
    "https://www.squarespace.com",
    "sadiebarnette.com",
    "https://wordpress.org"
  ],
  "filterTechnologies": ["Squarespace", "Squarespace Commerce"],
  "onlyMatching": false
}
```

Raise **Max concurrency** for large lists. Turn on **Proxy configuration** only if some sites block the platform's IP range — most do not.

### How detection works

Squarespace sites are recognisable from their first response: assets served from `static1.squarespace.com` and `assets.squarespace.com`, the `Static.SQUARESPACE_CONTEXT` object in an inline script, `squarespace-` body classes, the `crumb` cookie, and — for stores — the commerce script bundles and cart markup. The detector fetches each homepage once and checks the headers, cookies, HTML, script sources, inline scripts and meta tags against more than 7,600 technology fingerprints, then reports every match with a confidence score.

A site is only reported as Squarespace when the evidence sits on the page itself, not in an embedded third-party asset. Because the page's JavaScript is never executed, signals that only appear after scripts run are not evaluated; for Squarespace that does not matter — its server-rendered markup is the evidence.

The fingerprint database is the open-source webappanalyzer technology dataset, used under the GNU GPL v3. The matching engine in this actor is original code.

### Pricing

You pay per website saved to the dataset. With **Store only matching websites** on, that means per Squarespace site found; with it off, per site checked. There are no subscriptions, seats or minimums, and you can cap the maximum spend of a run before it starts.

### Scope and responsible use

The actor requests only the publicly served homepage of each URL you provide, exactly as a browser would. It requires no login, no cookies and no credentials, does not crawl beyond the page you give it, does not add anything to a cart, and does not attempt to bypass any access control or bot-protection challenge. You are responsible for using the results in accordance with the laws that apply to you and the terms of the websites you check.

### Limitations

- Password-protected or expired Squarespace sites return their placeholder page, which still identifies as Squarespace.
- A site on a custom domain that has since moved off Squarespace but keeps old assets can be reported at lower confidence.
- Very large media homepages that deliberately stall automated traffic can exceed the request timeout; they come back as rows with an `error` rather than being dropped.
- Only the URL you supply is fetched.

### Something not detected?

Open an issue on this actor's **Issues** tab with the URL and what you expected. Include a reproducible input and the expected signal so the report can be investigated.

### Interpret empty results and errors

A null technology field means no recognized signal was found in the inspected response; it does not prove absence. A returned error means that URL was not successfully analyzed. With `onlyMatching: true`, non-matches and errors are omitted from the dataset, so a zero-row result cannot distinguish an unavailable site from no matches. Start with `onlyMatching: false` when checking coverage.

Every saved row, including an error row, incurs the configured per-row event fee. Proxy selection and run duration can affect operating costs. Do not increase concurrency or enable a more expensive proxy merely to work around an unclear result.

For a reproducible problem, open this Actor’s Issues tab with a small public input, expected behavior and relevant error text. Remove tokens and confidential information. No response-time or uptime guarantee is offered.

### Use the result in an automation

In Make or n8n, use the Apify integration to run this Actor with the same JSON input, wait for completion, then retrieve its default dataset. Route failed runs and error rows to a review step before sending valid results to your spreadsheet or CRM. Scheduling does not make these Actors emit only new records: deduplicate downstream using the source URL or record ID.

For Node.js, install the official `apify-client` package and set your own `APIFY_TOKEN` environment variable. The following example starts a paid run with a small spending limit.

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const input = {
  "startUrls": [
    "https://www.squarespace.com",
    "https://www.sadiebarnette.com",
    "https://wordpress.org"
  ],
  "filterTechnologies": [
    "Squarespace",
    "Squarespace Commerce"
  ],
  "onlyMatching": false
};
const run = await client.actor('keystonelabs/squarespace-site-detector').call(input, {
  memory: 512, timeout: 180, maxTotalChargeUsd: 0.10
});
if (run.status !== 'SUCCEEDED') throw new Error('Run did not succeed: ' + run.id);
const { items } = await client.dataset(run.defaultDatasetId).listItems({ limit: 100 });
console.log(items);
```

The first 100 rows are retrieved in this example. Use the dataset API pagination for a larger result. Keep credentials out of shared inputs and source files.

### A useful next step

- [Website Tech Stack Detector | Bulk URL Lookup](https://apify.com/keystonelabs/tech-stack-detector): qualify a website list by its technology. This is a separate Actor with its own input and price.

### Understand the run at a glance

Open **Run summary** in Output for counts of unique URLs, analyzed responses, failures, matches and saved rows. It remains useful when `onlyMatching` produces an empty dataset. The summary is written at normal completion and does not add a billable dataset row. Failed or aborted runs may not have a final summary; check run status first. The summary contains counts only, not a second copy of scraped content.

# Actor input Schema

## `startUrls` (type: `array`):

Domains or URLs to test for Squarespace. Each one becomes a result with a matchesFilter flag.

## `filterTechnologies` (type: `array`):

Technology names that count as a match. The defaults cover Squarespace sites and Squarespace Commerce stores; add other site builders (Wix, Webflow, Framer) to compare adoption across them.

## `onlyMatching` (type: `boolean`):

Save only detected matches. Non-matches and error rows are omitted, so start with this off when reviewing coverage. Requires filterTechnologies.

## `maxConcurrency` (type: `integer`):

How many websites to analyze in parallel. Lower it if you are analyzing many pages on the same domain.

## `timeoutSecs` (type: `integer`):

Give up on a website after this many seconds. Large media and retail homepages can take 30 seconds or more to respond under load.

## `proxyConfiguration` (type: `object`):

Optional. Route requests through Apify Proxy if some target sites block your IP.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.squarespace.com",
    "https://www.sadiebarnette.com",
    "https://wordpress.org"
  ],
  "filterTechnologies": [
    "Squarespace",
    "Squarespace Commerce"
  ],
  "onlyMatching": false,
  "maxConcurrency": 20,
  "timeoutSecs": 45,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset of analyzed websites. Each item lists detected technologies with category, version and confidence.

## `workflowJson` (type: `string`):

Selected columns for this workflow. Inspect errors and missing values before using the data.

## `workflowCsv` (type: `string`):

Download the workflow columns as CSV. Use JSON for full nested arrays.

## `summary` (type: `string`):

Counts of analyzed, failed, matched, saved and omitted URLs. Use this to interpret a zero-row result.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://www.squarespace.com",
        "https://www.sadiebarnette.com",
        "https://wordpress.org"
    ],
    "filterTechnologies": [
        "Squarespace",
        "Squarespace Commerce"
    ],
    "onlyMatching": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("keystonelabs/squarespace-site-detector").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [
        "https://www.squarespace.com",
        "https://www.sadiebarnette.com",
        "https://wordpress.org",
    ],
    "filterTechnologies": [
        "Squarespace",
        "Squarespace Commerce",
    ],
    "onlyMatching": False,
}

# Run the Actor and wait for it to finish
run = client.actor("keystonelabs/squarespace-site-detector").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://www.squarespace.com",
    "https://www.sadiebarnette.com",
    "https://wordpress.org"
  ],
  "filterTechnologies": [
    "Squarespace",
    "Squarespace Commerce"
  ],
  "onlyMatching": false
}' |
apify call keystonelabs/squarespace-site-detector --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,keystonelabs/squarespace-site-detector"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Db0fn3lNtFOi0loun/builds/FBoeuHTV76Pj51M6H/openapi.json