Flowprise Leads API Reference

Authentication

All lead extraction, website intelligence, and outreach endpoints require authentication. You can generate and copy your secret API key directly from your dashboard with 1 click.

Pass your secret key in your HTTP request headers using either format:

// Method 1: Dedicated Header (Recommended)
X-API-Key: fp_live_YOUR_SECRET_KEY

// Method 2: Standard Bearer Token
Authorization: Bearer fp_live_YOUR_SECRET_KEY

Base URL

All endpoints documented below are hosted on your live production instance:

Rate Limits

To guarantee server stability and prevent bot spam, endpoints use rolling sliding-window limits per IP address:

• Lead Scrapers (Maps, SERP, Socials, SEO): 15 requests / minute
• Email Deliverability Verifier: 30 requests / minute
• Cold Outreach Send: 20 requests / minute

If exceeded, the server returns HTTP 429 Too Many Requests with a standard Retry-After: <seconds> header.

Universal Dispatcher

Execute any scraper engine through a single unified endpoint by passing the source parameter in your JSON payload.

curl -X POST https://lead.flowprise.tech/api/leads/extract \
  -H "X-API-Key: fp_live_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "maps",
    "query": "Chiropractor",
    "location": "Dallas, TX",
    "limit": 10
  }'

Google Maps Business Scraper

Extract local business listings, addresses, direct telephone numbers, reviews, website URLs, and underlying technology stacks directly from Google Maps.

curl -X POST https://lead.flowprise.tech/api/leads/maps \
  -H "X-API-Key: fp_live_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Dentist in Austin",
    "location": "Austin, TX",
    "limit": 15,
    "enrich": true
  }'

Google SERP & 1-Click SEO Pitch Scraper

Scrapes organic Google rankings for any keyword, diagnoses technical SEO bottlenecks, and automatically generates high-converting cold outreach email pitches praising their rank.

import requests

res = requests.post(
    "https://lead.flowprise.tech/api/leads/serp",
    headers={"X-API-Key": "fp_live_YOUR_SECRET_KEY"},
    json={"query": "rooftop solar delhi", "country": "in", "limit": 5}
)
data = res.json()
for lead in data.get("leads", []):
    print(f"Rank #{lead['position']} • {lead['domain']}")
    print(f"Subject: {lead['emailSubject']}\n")

Website Tech & Contact Auditor

Crawls homepage and contact pages to uncover corporate emails, direct phone numbers, WhatsApp links, social profiles (LinkedIn, IG, FB, Twitter), CMS engine, and advertising tracking pixels.

curl -X POST https://lead.flowprise.tech/api/leads/website \
  -H "X-API-Key: fp_live_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

LinkedIn Decision Maker X-Ray

Extracts indexed professional profiles, executive titles, companies, locations, and predicted email patterns without needing a premium LinkedIn account.

curl -X POST https://lead.flowprise.tech/api/leads/linkedin \
  -H "X-API-Key: fp_live_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "Chief Marketing Officer",
    "industry": "FinTech",
    "location": "New York",
    "limit": 15
  }'

Export Leads (CSV & JSON)

Instantly download current or filtered prospects into standard spreadsheets for CRM ingestion or offline analysis.

API Health & Monitoring

Query platform health status for uptime monitors (UptimeRobot, Render, Datadog).