{"info":{"version":"1.0.0","description":"Live business intelligence for 14M+ online businesses: tech stacks, Shopify apps, revenue and employee estimates, hiring signals with posting dates, SEO scores, and contact emails. Free tier: 1,000 lookups/month. Contact emails require a paid plan. Auth: 'Authorization: Bearer ls_...' (or X-API-Key). Errors are RFC 9457 problem+json with actionable detail.","title":"ListSignal API","contact":{"url":"https://listsignal.com/developers","email":"will@listsignal.com"}},"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http","description":"API key from listsignal.com Settings. Free tier: 1,000 calls/month."}}},"paths":{"/api/v1/company/{domain}":{"get":{"description":"Everything ListSignal knows about a domain: tech stack, Shopify apps, revenue/employee estimates, open jobs with a hiring overview, SEO score, traffic rank, and contact emails (paid plans). 404 when the domain is not yet in the dataset.","parameters":[{"in":"path","name":"domain","description":"Bare domain, e.g. gymshark.com (no scheme, no path)","required":true,"schema":{"type":"string","example":"gymshark.com"}}],"summary":"Get one company's full record by domain","operationId":"getCompany","responses":{"200":{"description":"Company record"},"401":{"description":"Missing or invalid API key (problem+json)"},"403":{"description":"Monthly quota exhausted (problem+json)"},"429":{"description":"Per-minute rate limit exceeded (problem+json, Retry-After header)"}}}},"/api/v1/search":{"get":{"description":"Filtered slice of the dataset, ranked by traffic. All filters combine with AND. Response echoes the accepted filters so a mistyped one is visible immediately.","parameters":[{"in":"query","name":"tech","description":"Technology name substring, e.g. Shopify, Klaviyo, HubSpot","required":false,"schema":{"type":"string"}},{"in":"query","name":"app","description":"Shopify app name substring, e.g. ReCharge","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","description":"ISO-2 country code, e.g. US, FR","required":false,"schema":{"type":"string"}},{"in":"query","name":"business_model","description":"One of: Ecommerce, SaaS, Agency, Marketplace, Tool, Media, Consulting","required":false,"schema":{"type":"string"}},{"in":"query","name":"revenue","description":"Revenue bracket, e.g. $1M-$10M","required":false,"schema":{"type":"string"}},{"in":"query","name":"hiring","description":"true to keep only companies with open jobs","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"default":25,"maximum":100,"type":"integer"}},{"in":"query","name":"offset","schema":{"default":0,"maximum":10000,"type":"integer"}}],"summary":"Search companies by technology, country, model, revenue, or hiring","operationId":"searchCompanies","responses":{"200":{"description":"Matching companies"},"401":{"description":"Missing or invalid API key (problem+json)"},"403":{"description":"Monthly quota exhausted (problem+json)"},"429":{"description":"Per-minute rate limit exceeded (problem+json, Retry-After header)"}}}},"/api/v1/stats":{"get":{"description":"Businesses tracked, Shopify stores, technologies, and domains checked in the past hour. Refreshed every 60 seconds. Citable.","summary":"Live dataset statistics","operationId":"getDatasetStats","responses":{"200":{"description":"Dataset statistics"},"401":{"description":"Missing or invalid API key (problem+json)"},"403":{"description":"Monthly quota exhausted (problem+json)"},"429":{"description":"Per-minute rate limit exceeded (problem+json, Retry-After header)"}}}},"/api/v1/technologies":{"get":{"summary":"All tracked technologies with company counts","operationId":"listTechnologies","responses":{"200":{"description":"Technology directory"},"401":{"description":"Missing or invalid API key (problem+json)"},"403":{"description":"Monthly quota exhausted (problem+json)"},"429":{"description":"Per-minute rate limit exceeded (problem+json, Retry-After header)"}}}}},"security":[{"bearerAuth":[]}],"openapi":"3.1.0","servers":[{"url":"https://listsignal.com"}]}