Qualow API

Access pre-qualified small business leads programmatically. Search by industry, location, and tech stack. Built for AI agents, automation workflows, and CRM integrations.

Base URLhttps://api.qualow.com/api/v1

Authentication

All requests require an API key sent via the X-API-Key header. Keys are tied to your account and subscription tier.

Header

X-API-Key: qlw_your_key_here

How to get your key

Create an account at qualow.com/signup
Subscribe to any plan (Starter, Pro, or Agency)
Go to Dashboard → API
Click “Generate API Key” and save it securely

GET

/leads

Search and filter pre-qualified leads. Returns up to 25 results per request, sorted by newest first. All filters are optional and combine with AND logic.

Query Parameters

job_title

string

Filter by job title. Case-insensitive partial match.

city

string

Filter by city name. Case-insensitive partial match.

state

string

Filter by state or province. Accepts abbreviations or full names (e.g. "IL" or "Illinois").

country

string

Filter by country. Case-insensitive partial match (e.g. "United States", "Canada").

industry

string

Filter by company industry (e.g. "construction", "healthcare", "retail").

tech

string

Search by technology or software the company uses (e.g. "quickbooks", "xero", "shopify"). Searches both tech_signals and tech_signals_meta.

Example Request

curl "https://api.qualow.com/api/v1/leads?industry=construction&state=IL" \
  -H "X-API-Key: qlw_your_key_here"

Example Response

{
  "count": 76,
  "leads": [
    {
      "id": "e4a1c3f0-8b2d-4e56-9f01-abc123def456",
      "employer_name": "Great Lakes Plumbing & Heating Company",
      "employer_website": "https://greatlakesph.com",
      "job_title": "Plumbing Contractor",
      "job_city": "Chicago",
      "job_state": "IL",
      "job_country": "United States",
      "job_is_remote": false,
      "job_posted_at": "2026-04-10T14:30:00Z",
      "company_industry": "Construction",
      "tech_signals": "QuickBooks, ServiceTitan",
      "tech_signals_meta": "QuickBooks Online detected via job listing",
      "category_bucket": null,
      "phone": "+1-773-555-0142",
      "email": "info@greatlakesph.com",
      "decision_maker": "Mike Dalton, Operations Manager",
      "socials": "linkedin.com/company/great-lakes-plumbing",
      "business_summary": {
        "description": "Full-service plumbing and heating contractor...",
        "revenue_estimate": "$2M-$5M",
        "years_in_business": 28,
        "pain_points": ["Manual scheduling", "Paper invoicing"],
        "growth_evidence": "3 new job postings in 60 days"
      }
    }
  ],
  "timestamp": "2026-04-17T10:00:00Z"
}

GET

/leads/{id}

Retrieve a single lead by its unique ID. Returns the same fields as the list endpoint.

Path Parameters

idrequired

uuid

The unique identifier of the lead.

Example Request

curl "https://api.qualow.com/api/v1/leads/e4a1c3f0-8b2d-4e56-9f01-abc123def456" \
  -H "X-API-Key: qlw_your_key_here"

Response Fields

Every lead includes the following fields. Fields may be null if data is unavailable.

id

uuid

Unique lead identifier

employer_name

string

Company name

employer_website

string

Company website URL

job_title

string

The listed job title or role

job_city

string

City of the position

job_state

string

State or province

job_country

string

Country

job_is_remote

boolean

Whether the position is remote-friendly

job_posted_at

datetime

When the job was originally posted (ISO 8601)

company_industry

string

Industry classification (e.g. Construction, Healthcare, Retail)

company_size

string

Employee count or range (e.g. '10-50', '51-200')

annual_revenue_readable

string

Estimated annual revenue (e.g. '$1M - $5M')

tech_signals

string

Software and tools the company uses (e.g. QuickBooks, Xero, Shopify)

tech_signals_meta

string

Context about how tech signals were detected

tech_stack

string

Known software and tools (e.g. 'QuickBooks, ServiceTitan, Google Workspace')

category_bucket

string

Lead category (bookkeeper, accounts_payable, billing, etc.)

phone

string

Contact phone number

email

string

Contact email address

decision_maker

string

Name and role of the key decision maker

socials

string

Social media links (LinkedIn, Twitter, etc.)

company_linkedin

string

LinkedIn profile URL of the decision maker or company

business_summary

object

AI-generated intelligence: company description, revenue estimate, years in business, pain points, growth signals, and more

Rate Limits

API requests are rate-limited per key based on your subscription tier. Limits reset at midnight UTC.

Plan	Requests / day
Starter ($99/mo)	100
Pro ($199/mo)	500
Agency ($349/mo)	2,000

When you exceed the limit, the API returns 429 Too Many Requests. Wait until midnight UTC for the counter to reset.

Errors

The API uses standard HTTP status codes. Errors return a JSON body with a detail field.

Code	Description
400	Invalid query parameters
401	Missing or invalid API key
404	Lead not found
429	Rate limit exceeded — wait until midnight UTC
500	Internal server error

Error response format

{
  "detail": "Rate limit exceeded — 100 requests/day. Resets at midnight UTC."
}

Code Examples

curl "https://api.qualow.com/api/v1/leads?industry=construction&state=IL" \
  -H "X-API-Key: qlw_your_key_here"

AI Tool Schema (Claude / GPT function calling)

{
  "name": "qualow_search_leads",
  "description": "Search for pre-qualified small business leads by location, industry, and tech stack.",
  "parameters": {
    "type": "object",
    "properties": {
      "job_title": { "type": "string", "description": "Job title filter" },
      "city":      { "type": "string", "description": "City filter" },
      "state":     { "type": "string", "description": "State or province" },
      "country":   { "type": "string", "description": "Country filter" },
      "industry":  { "type": "string", "description": "Company industry" },
      "tech":      { "type": "string", "description": "Technology or software" }
    }
  }
}

AI Agent Integration

Qualow is designed for programmatic access. Here are recommended patterns for AI agents and automation workflows.

Use targeted filters

Narrow queries with specific filters like industry=construction&state=IL to get the most relevant results. Each request returns up to 25 leads.

Track processed leads

Store the id of leads you've already processed. New leads are added regularly, so poll periodically and skip IDs you've seen.

Automation workflows

Works with N8N, Make, Zapier, or any HTTP-capable platform. Set up a scheduled trigger, call the API, and route leads into your CRM or outreach tool.

Ready to get started?

Create your account