Back to RocketReach

How do I Lookup Company Information Using the RocketReach API?

🚨 Important: Company lookups via the RocketReach API require Company Exports, which are separate from standard lookups and exports. To access company lookup functionality, you must purchase Company Exports through our sales team at sales@rocketreach.co.

Key Takeaways

  • Company lookups require a separate purchase of Company Exports.
  • You can search for companies using domain, name, or LinkedIn URL.
  • Company lookups return metadata such as industry, size, revenue, and social links.
  • API requests must include a valid API Key for authentication.
  • Rate limits apply—ensure you do not exceed your API usage limits.

What is a Company Lookup in RocketReach API?

A company lookup retrieves metadata information for a business, including:

  • Company name and industry
  • Website domain and email domain
  • Employee count and revenue
  • LinkedIn, social media links, and year founded

Unlike person lookups, company lookups do not return direct contact information for employees. To find contacts at a company, use the People Search API after retrieving company metadata.

How to Perform a Company Lookup

Step 1: Ensure You Have Company Export Access

Since Company Lookups require a separate purchase, confirm that your RocketReach plan includes Company Exports. If you’re unsure, contact sales@rocketreach.co to discuss pricing and enable access.

Step 2: Search for a Company Using API

You can identify a company using one or more of the following parameters:

  • Domain (Preferred)
  • Company Name
  • LinkedIn URL
  • Stock Ticker Symbol

Example: Company Lookup API Request (cURL)

curl --request GET --location 'https://api.rocketreach.co/api/v2/company/lookup' \
     --header 'Api-Key: YOUR_API_KEY' \
     --data-urlencode 'domain=tesla.com'

Example: Company Lookup Using Python

import requests

api_key = "YOUR_API_KEY"
company_domain = "tesla.com"

response = requests.get(
    f"https://api.rocketreach.co/api/v2/company/lookup",
    headers={"Api-Key": api_key},
    params={"domain": company_domain}
)

print(response.json())

✅ If successful, the API returns metadata for the company.

Example Company Lookup Response

If the request is valid, the API will return detailed company information:

{
  "id": 12345,
  "name": "Tesla, Inc.",
  "domain": "tesla.com",
  "email_domain": "tesla.com",
  "website_domain": "www.tesla.com",
  "ticker_symbol": "TSLA",
  "industry": "Automotive & Transportation",
  "year_founded": 2003,
  "num_employees": 100000,
  "revenue": 53100000000,
  "links": {
    "linkedin": "https://www.linkedin.com/company/tesla",
    "twitter": "https://twitter.com/tesla"
  },
  "address": {
    "street": "3500 Deer Creek Road",
    "city": "Palo Alto",
    "region": "California",
    "country": "USA"
  }
}

4. Best Practices for Company Lookups

To optimize your company searches, follow these guidelines:

  • Use the company’s website domain whenever possible – Domain-based lookups are the most accurate.
  • Double-check API access – Ensure that Company Exports are enabled before making requests.
  • Monitor API rate limits – Excessive requests may result in HTTP 429 Too Many Requests errors.
  • Cross-reference metadata – Use company metadata to refine people search queries for better results.

5. Common Company Lookup Errors and Solutions

Error Code Description Solution
400 Bad Request Missing required parameters. Ensure you provide domain, name, or LinkedIn URL in the request.
403 Forbidden API key lacks Company Lookup access. Contact sales@rocketreach.co to purchase Company Exports.
404 Not Found No company matches the search criteria. Verify the domain, name, or LinkedIn URL used in the request.
429 Too Many Requests Rate limit exceeded. Reduce request frequency or upgrade your API plan.
500 Internal Server Error Issue with RocketReach API. Retry after a few minutes or contact support@rocketreach.co.

You Might Also Like

 

Have more questions? Talk to us