SignalHire Companies Directory Extractor

Overview

The SignalHire Company Directory Scraper endpoint lets you pull company listings from the SignalHire directory by filtering on country and industry. Each page returns a batch of companies with firmographic data — names, locations, employee counts, LinkedIn profiles, and more.

Who Is This For?

Role	Use Case
Marketers	Build segmented company lists by industry and geography for targeted campaigns.
Lead Generation Teams	Source fresh company prospects from specific markets and hand them off to sales.
Developers	Automate directory scraping into data pipelines, CRMs, or prospecting tools.

What You Can Build

• Industry prospect lists — scrape all software companies in the US, or logistics firms in Germany, ready for outreach.
• Market research database — collect firmographic snapshots across industries and regions for competitive analysis.
• CRM seeding pipeline — automatically populate your CRM with fresh company records filtered to your target market.
• Lead enrichment workflow — combine with the Company Email Finder endpoint to go from company name to verified contact in one pipeline.
• Account-based marketing (ABM) targeting — identify and list companies in your ideal customer profile before your sales team reaches out.

Endpoint

POST https://api.scravity.com/v1/companies/directory

Cost: 2 credits per page (live) · 1 credit per page (cached)  ·  Avg. Response Time: ~4s

Authentication

Include your API key as a Bearer token in every request.

Authorization: Bearer YOUR_API_KEY

Request Body

Parameter	Type	Required	Description
country	string	Yes	ISO 3166-1 alpha-2 country code (e.g., us, uk, de).
industry	string	Yes	Industry slug (e.g., software-development, logistics).
page_number	integer	No	Page to retrieve, from 1 to 1000. Defaults to 1.

Code Examples

cURL

curl -X POST https://api.scravity.com/v1/companies/directory \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "us",
    "industry": "software-development",
    "page_number": 1
  }'

Python

import requests

url = "https://api.scravity.com/v1/companies/directory"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "country": "us",
    "industry": "software-development",
    "page_number": 1
}

r = requests.post(url, json=payload, headers=headers)
print(r.json())

JavaScript

const res = await fetch("https://api.scravity.com/v1/companies/directory", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    country: "us",
    industry: "software-development",
    page_number: 1
  })
});

const data = await res.json();
console.log(data);

Response Format

Success (200)

{
  "data": [
    {
      "company_name": "Acme Software Inc.",
      "company_logo": "https://...",
      "company_link": "https://www.acmesoftware.com",
      "founded_year": "2012",
      "employees": "51-200",
      "headquarters_location": "San Francisco, CA, US",
      "linkedin account": "https://linkedin.com/company/acme-software"
    }
  ]
}

No Results Found (404)

{
  "error": "No companies found matching criteria",
  "details": ["No results returned for the given country and industry combination."]
}

Insufficient Credits (402)

{
  "error": "Insufficient credits",
  "details": ["You need at least 2 credits to perform this action. Current balance: 0."]
}

Validation Error (422)

{
  "detail": [
    {
      "loc": ["body", "country"],
      "msg": "Field required",
      "type": "value_error.missing"
    }
  ]
}

Credits

Result	Cost
Live page result	2 credits
Cached page result	1 credit
No companies found (404)	0 credits

Rate Limits

Window	Limit
Per second	20 requests
Per minute	1,000 requests

Tips

• Use page_number to paginate through up to 1,000 pages per country/industry combination — each page is an independent request.
• Re-requesting the same country + industry + page combination costs only 1 credit instead of 2, so don't hesitate to refresh known pages.
• Pair this endpoint with Company Email Finder to go from a directory page straight to verified contacts in one automated flow.
• Check your balance with GET /v1/credits before paginating through large result sets.