API overview

FisherLeads watches for brand new sites on any platform the moment they appear and hands them to you, confirmed live and enriched. The API gives your own software the same feed the dashboard shows: pull it on demand, or have new matching stores pushed to you in real time with webhooks.

The API is available on the Enterprise plan. Everything is a plain HTTPS request that returns JSON, so it works from any language or tool. The base URL for every endpoint is:

https://fisherleads.com/v1

Quick startCopy Anchor Link

1. Open Dashboard, then Developers, and generate an API key. Copy it, it is shown only once.
2. Send it as a bearer token on every request (see Authentication).
3. Call /v1/leads and start filtering.

curl "https://fisherleads.com/v1/leads?platform=shopify&country=US" \
  -H "Authorization: Bearer fk_live_your_key_here"

That returns the newest US Shopify stores as JSON, newest first. Add filters to narrow it, or a webhook to get them pushed to you automatically instead of polling.

Rate limits and usageCopy Anchor Link

Each key may make up to 120 requests per minute, plus a generous monthly call allowance. Go over either and the API responds with 429 Too Many Requests; wait and retry. Check where you stand at any time with GET /v1/me:

{ "plan": "enterprise", "rate_limit_per_min": 120, "monthly_cap": 100000, "used_this_month": 812 }

List leadsCopy Anchor Link

GET /v1/leads returns the live feed as JSON, newest first, paginated. It accepts the same filters as the dashboard. All parameters are optional and combine with AND.

The response wraps the page in total, page, page_size and items:

{
  "total": 4231,
  "page": 1,
  "page_size": 50,
  "items": [
    {
      "domain": "example.com",
      "url": "https://example.com",
      "platform": "shopify",
      "site_type": "ecommerce",
      "country": "US",
      "niche": "beauty",
      "launched": "2026-06-30",
      "registered": "2026-06-24",
      "merchant": "Example Beauty Co",
      "product_count": 42,
      "email": "hello@example.com",
      "socials": { "instagram": "https://instagram.com/examplebeauty" },
      "tech": ["Klaviyo", "Meta Pixel"]
    }
  ]
}

Get one leadCopy Anchor Link

GET /v1/leads/:domain returns a single enriched store by its apex domain, or 404 if it is not a live store in the feed.

curl https://fisherleads.com/v1/leads/example.com \
  -H "Authorization: Bearer fk_live_your_key_here"

Response fieldsCopy Anchor Link

Every lead carries the same fields the dashboard shows. A field is omitted or null when we could not confirm it.

ErrorsCopy Anchor Link

The API uses standard HTTP status codes. The body is always JSON with a detail message you can log.