BootLeads API

Quick start

Copy your key from Account settings and send it as a Bearer token. The key works while your own Enterprise subscription is active.

curl https://bootleads.com/api/v2/stores/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": ["shopify"], "country": ["US"], "page": {"size": 100}, "fields": ["title", "contact"]}'

import requests

response = requests.post(
    "https://bootleads.com/api/v2/stores/search",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"platform": ["shopify"], "country": ["US"], "page": {"size": 100}, "fields": ["title", "contact"]},
    timeout=60,
)
data = response.json()
print(response.headers["X-Rows-Remaining"], [store["id"] for store in data["results"]])

const response = await fetch("https://bootleads.com/api/v2/stores/search", {
  method: "POST",
  headers: {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
  body: JSON.stringify({platform: ["shopify"], country: ["US"], page: {size: 100}, fields: ["title", "contact"]}),
});
const data = await response.json();
console.log(response.headers.get("X-Rows-Remaining"), data.results.map((store) => store.id));

The response is shown under POST /stores/search.

Rows and rate limits

• Every store returned by stores/search or stores/mget is one row off your balance. The balance grows by 50,000 rows at 00:00 UTC each day and holds up to 3,000,000 rows. See how the balance adds up.
• A request runs while the balance is above zero, so the last page can take it a little below zero. After that, requests return 429 with the code row_quota_exhausted until the next refill.
• Each API key can make 3 requests per second. Faster requests return 429 with the code rate_limit_exceeded.

How the balance adds up

The balance is not a monthly allowance. It grows a little every day you are subscribed, and your billing date does not change it.

• First purchase: your first Enterprise subscription starts the balance full, at 3,000,000 rows.
• Every day: at 00:00 UTC the balance grows by 50,000 rows. Rows you don't use carry over until the balance reaches 3,000,000, which is 60 days of refills.
• Renewals: renewing does not reset the balance or top it up. It keeps growing by the day, as before.
• If the subscription ends: the balance stops growing after the last day you paid for and keeps the rows you had. When you subscribe again, it grows again from the next day. The days in between add nothing.

For example, one account over four months:

Pagination and syncing

Search results come in pages of up to 100 stores, ordered by created_at (newest first unless you set sort.created_at to asc). While has_more is true, pass next_cursor back in page.cursor for the next page; on the last page it is an empty string. A cursor keeps the filters, sort and fields of the request that started it, so send it without filters or sort. Cursors do not expire: you can stop and continue days later. A cursor issued before a change to our filters is rejected with cursor_invalid_or_expired; start a new search.

Keeping a copy in sync

Every page also returns resume_cursor, a bookmark just after the last store on the page, and the last page has one too. What it brings back depends on the sort order:

• Oldest first (sort.created_at set to asc): it is a sync bookmark. Pass it later and you get the stores added since that match the cursor's filters. Use this to keep a copy of the data.
• Newest first (the default): it carries on towards older stores. It picks up a run you stopped halfway, but it never brings newer stores. To check for new stores in this order, set created_at.min to the newest created_at you already have, and drop the ids you have seen.

1. First run: send platform and status with sort.created_at set to asc, page until has_more is false, and save resume_cursor with each page you store.
2. A whole platform can hold more stores than your row balance. When a request returns row_quota_exhausted, stop and continue from the saved cursor after the next refill.
3. Every day after: send the saved cursor, page to the end and save the new resume_cursor.
4. Store results by id: a store can come back more than once.
5. Every few days, send the ids of stores you hold as password_protected to /stores/mget to see which have opened.

import time

import requests

API = "https://bootleads.com/api/v2/stores/search"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
FIRST_RUN = {
    "platform": ["shopify"],
    "status": ["active", "password_protected"],
    "sort": {"created_at": "asc"},
    "page": {"size": 100},
}


def sync(bookmark=None):
    """Page from the bookmark to the end; returns the bookmark for the next run."""
    body = {"page": {"size": 100, "cursor": bookmark}} if bookmark else FIRST_RUN
    while True:
        resp = requests.post(API, json=body, headers=HEADERS, timeout=60)
        if resp.status_code == 429:
            if resp.json()["error"]["code"] == "row_quota_exhausted":
                return bookmark  # out of rows: run again after the refill
            time.sleep(int(resp.headers.get("Retry-After", 1)))  # too fast: wait, then retry
            continue
        resp.raise_for_status()
        data = resp.json()
        bookmark = data["resume_cursor"]
        save(data["results"], bookmark)  # upsert by id and keep the bookmark together
        if not data["has_more"]:
            return bookmark
        body = {"page": {"size": 100, "cursor": data["next_cursor"]}}

Endpoints

curl https://bootleads.com/api/v2/stores/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": ["shopify"],
    "country": ["US", "CA"],
    "technologies": ["klaviyo"],
    "product_count": {"min": 20},
    "page": {"size": 100},
    "fields": ["title", "country", "contact", "social"]
  }'

{
  "has_more": true,
  "next_cursor": "eyJ2IjoyLCJhZnRlciI6WzE3NjA5NDc5NjQwMDAsImV4YW1wbGUtc3RvcmUuY29tIl0s...",
  "resume_cursor": "eyJ2IjoyLCJhZnRlciI6WzE3NjA5NDc5NjQwMDAsImV4YW1wbGUtc3RvcmUuY29tIl0s...",
  "results": [
    {
      "id": "example-store.com",
      "created_at": "2026-10-20T08:12:44+00:00",
      "title": "Example Store",
      "country": "US",
      "contact": {"email": ["hello@example-store.com"], "phone": ["+1 555 123 4567"]},
      "social": {"platforms": ["instagram"], "total_followers": 15200}
    }
  ]
}

{
  "id": "example-store.com",
  "platform": "shopify",
  "title": "Example Store",
  "description": "Handmade leather shoes, shipped from New York.",
  "categories": [
    "Apparel & Accessories / Shoes & Footwear"
  ],
  "country": "US",
  "language": "en",
  "status": "active",
  "is_cod": false,
  "has_ios_app": false,
  "has_android_app": false,
  "created_at": "2025-01-15T10:30:00.000Z",
  "updated_at": "2025-03-20T14:00:00.000Z",
  "product": {
    "count": 128,
    "avg_price": 39.99,
    "avg_price_usd": 39.99,
    "currency": "USD"
  },
  "apps": {
    "active": [
      {
        "slug": "example-app",
        "name": "Example Reviews App",
        "image": "https://cdn.shopify.com/app-store/listing_images/xxx/icon/xxx.png",
        "url": "https://apps.shopify.com/example-app"
      }
    ]
  },
  "technologies": {
    "active": [
      {
        "id": "klaviyo",
        "name": "Klaviyo",
        "category": "email_sms_marketing",
        "website": "https://www.klaviyo.com/"
      }
    ],
    "checked_at": "2025-03-20T14:00:00.000Z"
  },
  "contact": {
    "email": [
      "hello@example-store.com"
    ],
    "phone": [
      "+12125550147"
    ],
    "whatsapp": [
      "12125550147"
    ]
  },
  "social": {
    "platforms": [
      "instagram",
      "tiktok"
    ],
    "total_followers": 18400,
    "link": {
      "instagram": "https://www.instagram.com/examplestore",
      "tiktok": "https://www.tiktok.com/@examplestore"
    },
    "followers": {
      "instagram": 15200,
      "tiktok": 3200
    }
  },
  "fb_ads": {
    "count": 12,
    "last_start_date": "2025-03-18T00:00:00+00:00"
  },
  "shopify": {
    "myshopify": "example-store.myshopify.com",
    "theme_schema_name": "Dawn",
    "registration_country": "US",
    "city": "New York",
    "province": "New York",
    "ships_to_countries": [
      "US",
      "CA",
      "GB"
    ],
    "offers_installments": false,
    "payment_methods": [
      "SHOP_PAY",
      "APPLE_PAY"
    ]
  }
}

curl https://bootleads.com/api/v2/stores/mget \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["example-store.com", "unknown-store.com"], "fields": ["platform", "product"]}'

{
  "missing_ids": ["unknown-store.com"],
  "results": [
    {
      "id": "example-store.com",
      "created_at": "2025-01-15T10:30:00+00:00",
      "platform": "shopify",
      "product": {"count": 128, "avg_price": 39.99, "avg_price_usd": 39.99, "currency": "USD"}
    }
  ]
}

curl "https://bootleads.com/api/v2/filters?key=country" -H "Authorization: Bearer YOUR_API_KEY"

{
  "filters": [
    {
      "key": "country",
      "type": "array",
      "description": "Where the store is based, not where it sells ...",
      "docs_url": "https://bootleads.com/data/filters/#filter-country",
      "values": [{"key": "US", "label": "United States", "count": 2154021}, ...]
    }
  ]
}

Filters

Filters are top-level keys of the search body. Each one narrows the results; several values in one filter match a store that has any of them. Ranges take {"min": .., "max": ..}, both inclusive and either optional; dates are ISO 8601 and use UTC. The descriptions are the ones in the store search, so the filter reference shows the same text.

Basics

Products

Contact & social

Advertising

Business & traits

Technologies & apps

Domain

Response fields

Each store is a JSON object keyed by its domain in id; fields without a value are left out or come back empty. To get less, pass fields with any of the top-level keys below; id and created_at always come back.

• platform
• title
• description
• country
• language
• status
• categories
• is_dropshipping
• is_cod
• is_print_on_demand
• has_ios_app
• has_android_app
• updated_at
• product
• apps
• technologies
• contact
• social
• fb_ads
• shopify

The figure on the right is the share of stores that have the field.

Store basics

Geography & classification

Products & pricing

Contact

Social reach

Ads & technology

Dates

Errors

Errors return a status code and a JSON body with a stable code and a readable message:

{"error": {"code": "row_quota_exhausted", "msg": "Row balance is used up. It refills at 00:00 UTC."}}