Organizations Search API

Search for organization information using domain names or organization names.

warning

OEM API requires special partner access. Contact FullHunt sales to enable OEM capabilities on your account.

Search Organization Data

Search for comprehensive organization information using domain names or organization names.

HTTP Request

POST https://fullhunt.io/api/v1/oem/organizations/search

Request Body Parameters

Parameter	Required	Type	Description
type	Yes	string	Type of search to perform. Valid values: "domain", "organization"
query	Yes	string	The domain or organization name to search for
query_tags	No	object	Key-value pairs for client-specific tracking

Supported Search Types

Type	Description	Example
`domain`	Search by domain name	`"uber.com"`
`organization`	Search by organization name	`"uber"`

Example Request

curl -X POST "https://fullhunt.io/api/v1/oem/organizations/search" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "organization",
    "query": "uber",
    "query_tags": {
      "client_name": "ACMECorp",
      "workspace": "production"
    }
  }'

Example Response

{
  "response": [
    {
      "company_name": "Uber Technologies, Inc.",
      "other_names": ["Uber"],
      "domain": "uber.com",
      "description": "Uber is a technology company that offers ride-hailing services, food delivery, and other transportation services.",
      "market": "Transportation, Mobility, Technology",
      "estimated_employee_count": "29,300",
      "headquarters_location": {
        "city": "San Francisco",
        "state": "California",
        "country": "United States"
      },
      "year_founded": "2009",
      "leadership_key_executives": [
        {
          "name": "Dara Khosrowshahi",
          "title": "Chief Executive Officer"
        },
        {
          "name": "Nelson Chai",
          "title": "Chief Financial Officer"
        }
      ],
      "stock_info": {
        "stock_symbol": "UBER",
        "exchange": "NYSE"
      },
      "social_media_presence": {
        "linkedin": "https://www.linkedin.com/company/uber-com/",
        "twitter": "https://twitter.com/Uber",
        "facebook": "https://www.facebook.com/uber",
        "instagram": "https://www.instagram.com/uber/"
      },
      "notable_breaches_security_incidents": [
        {
          "date": "21-11-2017",
          "description": "Uber revealed a data breach that exposed personal data of 57 million customers and drivers.",
          "impact": "The breach exposed names, email addresses, phone numbers, and driver's license numbers.",
          "source": "https://www.nytimes.com/2017/11/21/technology/uber-hack.html"
        }
      ],
      "public_code_organization": {
        "name": "uber",
        "platform": "GitHub",
        "url": "https://github.com/uber"
      },
      "subsidiaries": [
        {
          "name": "Uber Eats",
          "domain": "ubereats.com",
          "description": "Uber Eats is Uber's food delivery platform that allows customers to order food from local restaurants.",
          "other_domains": []
        },
        {
          "name": "Uber Freight",
          "domain": "uberfreight.com",
          "description": "Uber Freight is Uber's logistics platform that connects carriers with shippers.",
          "other_domains": []
        }
      ],
      "other_domains": ["uber.com", "ubereats.com", "uberfreight.com"]
    }
  ]
}

Response Fields

Organization Object Fields

Field	Type	Description
`company_name`	string	Official company name
`other_names`	array	Alternative names or aliases
`domain`	string	Primary domain of the organization
`description`	string	Description of the organization
`market`	string	Market sectors the organization operates in
`estimated_employee_count`	string	Estimated number of employees
`headquarters_location`	object	Location information
`year_founded`	string	Year the organization was founded
`leadership_key_executives`	array	Key executives and leadership
`stock_info`	object	Stock information if publicly traded
`social_media_presence`	object	Social media profiles
`notable_breaches_security_incidents`	array	Known security incidents
`public_code_organization`	object	Public code repositories
`subsidiaries`	array	Subsidiary companies
`other_domains`	array	Additional domains owned by the organization

Headquarters Location Fields

Field	Type	Description
`city`	string	City where headquarters is located
`state`	string	State or province
`country`	string	Country

Executive Object Fields

Field	Type	Description
`name`	string	Executive's name
`title`	string	Executive's title

Stock Information Fields

Field	Type	Description
`stock_symbol`	string	Stock ticker symbol
`exchange`	string	Stock exchange

Field	Type	Description
`linkedin`	string	LinkedIn company page URL
`twitter`	string	Twitter/X account URL
`facebook`	string	Facebook page URL
`instagram`	string	Instagram account URL

Security Incident Fields

Field	Type	Description
`date`	string	Date of the incident
`description`	string	Description of the incident
`impact`	string	Impact of the incident
`source`	string	Source or reference URL

Public Code Organization Fields

Field	Type	Description
`name`	string	Organization name on the platform
`platform`	string	Platform name (e.g., "GitHub")
`url`	string	URL to the organization's profile

Subsidiary Fields

Field	Type	Description
`name`	string	Subsidiary name
`domain`	string	Subsidiary's primary domain
`description`	string	Description of the subsidiary
`other_domains`	array	Additional domains owned by the subsidiary

Use Cases

Organization Intelligence

Research target organizations for business intelligence
Gather comprehensive company information
Identify subsidiaries and related entities

Security Assessment

Identify potential attack vectors through organization structure
Research security incidents and breach history
Analyze organizational digital footprint

Partner Integration

Integrate organization data into security platforms
Provide comprehensive company intelligence to clients
Build threat intelligence solutions

Query Tags for Tracking

Use the query_tags parameter to track searches by client or context:

{
  "query_tags": {
    "client_id": "client_123",
    "client_name": "ACME Corporation",
    "workspace": "production",
    "search_type": "organization_intel",
    "user_id": "user456"
  }
}

Rate Limiting

OEM Organizations Search API has custom rate limits based on your partner agreement:

Negotiated limits based on usage requirements
Burst capacity for high-volume periods
Priority processing for partner requests

Error Handling

The API returns standard HTTP status codes:

Status Code	Description
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
403	Forbidden - OEM access not enabled
429	Rate limit exceeded
500	Internal server error

Data Sources

Organization data is compiled from multiple sources:

Public company filings and documents
Social media profiles and websites
Security incident databases
Public code repositories
Business intelligence databases

Security Considerations

All data is transmitted over HTTPS
API keys should be kept secure and rotated regularly
Results may contain sensitive organizational information
Consider implementing additional access controls in your platform
Be mindful of data privacy regulations when using organization data

Search Organization Data​

Organization Object Fields​

Headquarters Location Fields​

Executive Object Fields​

Stock Information Fields​

Social Media Presence Fields​

Security Incident Fields​

Public Code Organization Fields​

Subsidiary Fields​

Use Cases​

Organization Intelligence​

Security Assessment​

Partner Integration​

Query Tags for Tracking​

Rate Limiting​

Error Handling​

Data Sources​

Security Considerations​