# TechLeads

> TechLeads (https://techleads.fyi) is a B2B technographics and lead-generation platform. We detect technologies used on 450M+ websites, build filterable lead lists, estimate conservative SaaS technology spend, and expose data through a web dashboard, public pages, REST APIs, and a remote MCP server for AI assistants.

## What we do

TechLeads helps sales, marketing, and growth teams find companies by **technology stack** — similar in spirit to BuiltWith or Wappalyzer, with stronger **list building**, **exports**, and **API-first** workflows.

Core capabilities:
- **Website technology lookup** — CMS, ecommerce, analytics, CDNs, payments, marketing automation, frameworks, and 11,000+ searchable technologies.
- **Technology spend estimate (USD)** — conservative monthly/annual SaaS spend per domain (aggregate only; never per-tool pricing exposed to customers).
- **Lead list search** — filter 450M+ domains by technologies, keywords, TLDs, country, industry, exclusions; preview in dashboard; export CSV.
- **Contact enrichment** — business emails, phones, social links where available (compliance-aware).
- **Bulk domain lookup** — upload up to 10,000 domains; async jobs with CSV download.
- **Alerts & monitoring** — email when tracked domains change technologies.
- **Chrome extension** — on-page technology detection while browsing.

## Website — key pages (human + AI crawlers)

| Page | URL | Purpose |
|------|-----|---------|
| Home | https://techleads.fyi/ | Product overview |
| Public lookup | https://techleads.fyi/lookup/{domain} | Live tech stack + spend estimate for any domain (e.g. https://techleads.fyi/lookup/shopify.com) |
| Technologies catalog | https://techleads.fyi/technologies | Browse 11k+ technologies with usage counts |
| Technology detail | https://techleads.fyi/technology/{name} | Single-technology landing pages |
| Pricing | https://techleads.fyi/pricing | Plans and credits |
| API docs (UI) | https://techleads.fyi/docs | Customer-facing API documentation |
| Discovery feed | https://techleads.fyi/discovery | Daily new-technology discoveries (public) |
| Dashboard (auth) | https://techleads.fyi/dashboard | Lead search, website lookup, bulk lookup, exports, alerts, API keys |
| Website lookup (auth) | https://techleads.fyi/dashboard → Website Lookup tab | Single-domain lookup + bulk upload history |
| Domain lookup jobs | https://techleads.fyi/dashboard/domain-lookup | Bulk technology lookup jobs (CSV in/out) |
| Contact | https://techleads.fyi/contact | Support and sales |
| Survey (20% off) | https://techleads.fyi/survey2026 | New-user feedback survey; SURVEY20 discount applied manually after submit |

## Dashboard features (signed-in users)

- **Lead search** — multi-technology filters, keywords, TLD/country/industry, paginated preview, optional **Tech Spend/mo** column, CSV/XLSX export.
- **Website lookup** — instant single-domain scan with technology spend card (USD).
- **Bulk lookup** — paste or upload domains (1 credit/domain, up to 10k); email when CSV ready.
- **Saved queries & export history** — re-run and download past reports.
- **Alerts** — notify when domains add/remove technologies.
- **API keys** — create keys for programmatic access (credit-based).

## Public APIs (no authentication)

These endpoints are intentionally public:

| Endpoint | Method | Description |
|----------|--------|-------------|
| https://techleads.fyi/llms.txt | GET | This file — product & API summary for LLMs |
| https://techleads.fyi/llms-full.txt | GET | Extended reference |
| https://api.techleads.fyi/health | GET | API health check |
| https://api.techleads.fyi/llms.txt | GET | Backend API reference (subset) |
| https://techleads.fyi/api/v3 | GET | Customer API v3 service info |
| https://techleads.fyi/contact | POST | Contact form (via site) |
| https://api.techleads.fyi/contact | POST | Contact form (backend) |
| https://api.techleads.fyi/usage/track | POST | Extension usage analytics |
| https://api.techleads.fyi/feature-request | POST | Feature requests |
| https://api.techleads.fyi/discovery/daily-tech | GET | Daily tech discovery feed |
| https://api.techleads.fyi/alerts/preview | GET | Alert preview (public) |
| https://api.techleads.fyi/alerts/subscribe | POST | Alert subscription (public) |
| https://api.techleads.fyi/verify-payment | POST | Payment verification (datasets) |

## Customer API v3 (API key required)

Base URL: **https://techleads.fyi/api/v3**

Authentication: `Authorization: Bearer <your_api_key>` or `x-api-key: <your_api_key>`

Create keys at https://techleads.fyi/dashboard → API Keys (after sign-up).

| Endpoint | Credits | Description |
|----------|---------|-------------|
| GET/POST /api/v3/web/lookup?url= | 1 | Detect technologies + technology_spend for one URL |
| POST /api/v3/web/lookup/batch | 1×URLs | Batch lookup (up to 1,000 URLs) |
| POST /api/v3/web/lookup/bulk | varies | Async job up to 10,000 domains |
| GET /api/v3/email/verify | 2 | Email verification |
| GET /api/v3/account/info | 0 | Credits balance |
| GET /api/v3/account/usage | 0 | Usage history |

Example — lookup with spend:
```bash
curl -s "https://techleads.fyi/api/v3/web/lookup?url=recordedfuture.com" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Response includes `technology_spend`: `{ monthly_usd, annual_usd, priced_technologies, total_technologies, disclaimer }` (USD, conservative estimate).

## Backend API (api.techleads.fyi)

Used by the TechLeads dashboard and integrations. Requires `x-admin-api-key` (scoped keys) unless listed as public above.

Notable authenticated routes:
- GET /web/lookup?url= — live detection + spend
- GET /search/lead-list/v2 — lead search (ClickHouse)
- GET /technology/{slug}/insights — technology usage stats
- POST /export/lead-list — async CSV export

Enterprise v2 base: https://api.techleads.fyi/v2/ (credit-based, OpenAPI at /v2/docs on enterprise listener).

## MCP — Model Context Protocol (AI assistants)

TechLeads exposes a **remote MCP server** so companies can connect ChatGPT, Claude, Cursor, and other MCP clients to our data.

| Item | Value |
|------|-------|
| MCP URL | https://api.techleads.fyi/mcp |
| Transport | Streamable HTTP (MCP spec) |
| Auth | `Authorization: Bearer <TechLeads API key>` on each request |
| Health | https://api.techleads.fyi/mcp/health |

### MCP tools

| Tool | Description |
|------|-------------|
| lookup_website | Detect technologies + USD spend estimate for a domain or URL |
| search_leads | Find companies using specified technologies (filters: keyword, country, limit) |
| get_technology_insights | Usage stats and co-occurrence for a technology slug |
| verify_email | Validate a business email address |
| list_technologies | Search the technology catalog by name |

### Claude Desktop / Cursor config example

```json
{
  "mcpServers": {
    "techleads": {
      "url": "https://api.techleads.fyi/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TECHLEADS_API_KEY"
      }
    }
  }
}
```

Get an API key: https://techleads.fyi/signup → Dashboard → API Keys.

## Data & methodology (summary)

- Detection uses HTTP headers, HTML/JS fingerprints, DNS, and related signals (Wappalyzer-compatible corpus, 11k+ prod technologies).
- **Technology spend** sums entry-tier monthly USD for detected paid SaaS; open-source and one-time products excluded; capped per tool; no per-vendor pricing exposed.
- Lead database: 450M+ domains with technology tags and enrichment fields (emails, phones, social, firmographics where available).
- Freshness: continuous crawls and certstream live discovery; records include last-seen semantics.

## Positioning

- **vs BuiltWith / Wappalyzer**: similar technographic detection; TechLeads emphasizes lead-list workflows, exports, API/MCP access, and transparent aggregate spend estimates.
- **Ideal users**: SDRs, growth marketers, partnerships, founders building ICP lists from tech stacks.

## Compliance & contact

- Business contact data only; suppression and opt-out honored.
- Privacy: https://techleads.fyi/privacy-policy
- Terms: https://techleads.fyi/terms-and-conditions
- Support: support@techleads.fyi
- Security: security@techleads.fyi
- Status: https://status.techleads.fyi

## Extended reference

Full schemas, rate limits, and examples: https://techleads.fyi/llms-full.txt and https://techleads.fyi/docs