Company Directory Scraper

Overview

The Company Directory Scraper endpoint extracts lists of companies from the SignalHire directory based on country and industry filters. Get structured company data—names, logos, locations—ready for market analysis and lead list building.

Who Is This For?

What You Can Build

• Market mapping tools — Visualize industry distribution and density by country.
• Lead list builders — Create filtered company lists for outbound campaigns.
• Competitor analysis dashboards — Track companies in specific industries and locations.
• Territory planning systems — Assign sales territories based on industry concentration.
• Industry benchmarking platforms — Compare company metrics across regions.

Endpoint

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

Cost: 2 credits per new search  ·  Cached Search: 1 credit

Authentication

Include your API key as a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Request Body

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": "Example Tech",
"company_logo": "https://example.com/logo.png",
"company_link": "https://signalhire.com/companies/example-tech",
"founded_year": "2015",
"employees": "51-200",
"headquarters_location": "San Francisco, CA",
"linkedin_account": "https://www.linkedin.com/company/example-tech"
}
]
}

No Companies Found (404)

{
"error": "No companies found matching criteria",
"domain": null,
"details": ["No companies found for country 'us' and industry 'nonexistent-industry'."]
}

Credits

Rate Limits

Tips

• Use the IndustryEnum list to find valid industry slugs.
• Paginate through results using page_number (1-1000).
• Cached searches are cheaper—check if data was recently processed.
• Combine with the Domain Email Finder to get emails for listed companies.