Organizations Database Search API
The Organizations Database Search API allows you to search for organizations by name or domain in FullHunt's comprehensive organizations database. This API provides detailed information about companies, including their domains, subsidiaries, stock information, and more.
Rate limiting: Requests are limited to 60 requests per minute.
Authentication: Requires API key and enterprise account.
Search Organizations
Search for organizations by company name or domain name.
HTTP Request
GET https://fullhunt.io/api/v1/organizations-db/search
URL Parameters
Parameter | Description |
---|---|
query | The search query (organization name or domain). Must be 3-100 characters long. |
Example Request
curl "https://fullhunt.io/api/v1/organizations-db/search?query=uber" \
-H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"
Example Response
{
"response": [
{
"domain": "uber.com",
"company_name": "Uber Technologies Inc",
"other_names": ["Uber", "Uber Technologies"],
"subsidiaries": [
{
"name": "Uber Eats",
"domain": "ubereats.com",
"other_domains": ["ubereats.org"]
}
],
"stock_info": {
"stock_symbol": "UBER",
"exchange": "NYSE"
},
"other_domains": ["uber.org", "uber.net"]
}
]
}
Response Fields
Field | Type | Description |
---|---|---|
response | Array | Array of organization objects matching the search query |
domain | String | Primary domain of the organization |
company_name | String | Official company name |
other_names | Array | Alternative names or aliases for the company |
subsidiaries | Array | List of subsidiary companies |
subsidiaries.name | String | Name of the subsidiary |
subsidiaries.domain | String | Primary domain of the subsidiary |
subsidiaries.other_domains | Array | Additional domains of the subsidiary |
stock_info | Object | Stock market information (if publicly traded) |
stock_info.stock_symbol | String | Stock ticker symbol |
stock_info.exchange | String | Stock exchange where the company is listed |
other_domains | Array | Additional domains associated with the organization |
Search Behavior
The search function performs intelligent matching across multiple fields:
- Domain matching: Searches primary domains and additional domains
- Company name matching: Searches official company names and alternative names
- Subsidiary matching: Searches subsidiary names and domains
- Stock symbol matching: Searches stock ticker symbols
The search uses both regex pattern matching (for prefix matching) and full-text search to provide comprehensive results.
Error Responses
Status Code | Error | Description |
---|---|---|
400 | Missing required parameter: query | The query parameter is required |
400 | Query must be at least 3 characters long | Search query is too short |
400 | Query must be less than 100 characters long | Search query is too long |
401 | Unauthorized access | Invalid or missing API key |
403 | Access forbidden | API key doesn't have enterprise access |
Use Cases
Corporate Intelligence
- Research company structures and subsidiaries
- Identify related domains and digital assets
- Understand corporate relationships
Security Research
- Map organization digital footprint
- Identify potential attack surfaces
- Research company infrastructure
Business Development
- Research potential partners or competitors
- Understand company portfolio
- Identify business relationships
Compliance and Due Diligence
- Verify company information
- Research corporate structure
- Identify associated entities