@techleads.fyi/api
v0.3.1
Published
TechLeads API v3 SDK and CLI — website lookup, lead search, enrichment, bulk jobs
Maintainers
Readme
@techleads.fyi/api
TechLeads API v3 SDK + CLI (tlf / techleads) — website lookup, lead search, domain enrichment, and bulk jobs.
Install
npm i @techleads.fyi/api
# global CLI
npm i -g @techleads.fyi/api
# or one-off
npx tlf -d example.comSDK
import { TechLeads } from '@techleads.fyi/api'
const tl = new TechLeads({ apiKey: process.env.TECHLEADS_API_KEY })
// Website lookup (1 credit; free within 30 days of a prior charge)
const r = await tl.lookup('example.com')
console.log(r.technologies, r.technology_spend)
await tl.lookupBatch(['shopify.com', 'stripe.com'])
// Lead search — count/sample free; results = 1 credit per website
const count = await tl.leadsSearch({
mode: 'count',
technologies: ['Shopify', 'Klaviyo'],
country: 'DE',
})
const leads = await tl.leadsSearch({
mode: 'results',
technologies: 'Shopify',
country: 'US',
limit: 100,
})
// Enrich domains from the index (or refresh: 'live')
await tl.leadsDomains({ domains: ['shopify.com', 'kinsta.com'], refresh: 'cached' })
// Async bulk lookup (up to 10,000)
const job = await tl.startBulkLookup(['a.com', 'b.com'])
await tl.getBulkJob(job.data!.job_id)
const account = await tl.account()Base URL defaults to https://techleads.fyi/api/v3.
CLI
tlf login
tlf -d example.com
tlf -d example.com,x.com --format table
tlf -i domains.txt -o out.csv --format csv
tlf -d example.com --json
tlf -d example.com --names
tlf -u
# Lead search
tlf search --tech Shopify --country DE --mode count
tlf search --tech Shopify,Klaviyo --country DE --mode sample
tlf search --tech Shopify --country US --limit 50
# Domain enrichment
tlf domains shopify.com,kinsta.com
tlf domains -i domains.txt --refresh live
# Bulk jobs
tlf bulk -i domains.txt
tlf bulk-status <job_id>
tlf bulk-results <job_id>
tlf bulk-download <job_id> -o out.csv| Flag / command | Meaning |
|------|---------|
| -d / --domains | Comma-separated domains |
| -i / --input | File, one domain per line |
| -o / --output | Write to file |
| --format text\|table\|csv\|json | Output format (default text) |
| --json | Same as --format json |
| --names | Names only (lookup) |
| --fresh | Rescan now |
| search | Lead search (--tech, --country, --mode, …) |
| domains | Enrich domains |
| bulk / bulk-status / bulk-results / bulk-download / bulk-cancel | Async bulk jobs |
| --key | API key override |
| -u / whoami | Account + credits |
Config: ~/.config/techleads/config.json or TECHLEADS_API_KEY.
Docs: https://techleads.fyi/developers
Development
git clone [email protected]:techleads-fyi/api.git
cd api
npm i
npm run build
node bin/tlf.js -hPublish (maintainers): npm publish --access public (runs prepublishOnly → tsc).
