Skip to main content
GET
/
api
/
enterprise
/
company
/
search
const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer Token");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "q": "wokelo"
});

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("{{path}}/api/enterprise/company/search?query=wokelo&search_by=name&company_type=all", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
{
    "status": "success",
    "data": [
        {
            "name": "Wokelo AI",
            "permalink": "wokelo-ai",
            "short_description": "Wokelo builds purpose-built AI agents for dealmaking and consulting.",
            "founded_year": "2023",
            "ipo_status": "private",
            "hq": "Seattle, United States",
            "industries": "AI Investment Research Platform",
            "website": "https://www.wokelo.ai/",
            "ticker": "",
            "country_code": "US",
            "country": "United States",
            "domain": "wokelo.ai",
            "last_funding_round": "Seed"
        }
    ],
    "count": 10
}

Overview

Search for companies using name, website or ticker. It returns a list of companies with their permalink and other attributes.

Endpoint Details

  • Method: GET
  • Endpoint: /api/enterprise/company/search

Authentication requirements

  • Include a valid JWT token in your request header
  • If you don’t have a token yet, you can get one from the /auth/token/ endpoint first.

Request

Header Parameters

token
string
required
JWT token obtained from the Authentication request

URL Parameters

query
string
required
The search query string (e.g., company name, website or ticker).Examples: Tesla OR https://tesla.com OR TSLA
search_by
string
Field to search by. Supported value: name, website, ticker
company_type
string
Filter by company type. Supported values: private, public, allNote: Use all to return all types. (This is the default value is nothing is mentioned)

Response

Successful Response Fields Returns a JSON object with the following structure:
status
string
"success" if the request was processed successfully.
data
array
List of matching company objects.
count
integer
Total number of results returned.
Company Object Fields
FieldDescription
nameCompany name.
permalinkUnique identifier/slug for the company.
short_descriptionBrief description of the company.
founded_yearYear the company was founded.
ipo_statusIPO status (e.g., private, public).
hqHeadquarters location.
industriesIndustry or sector the company operates in.
websiteCompany website URL.
tickerStock ticker symbol (if applicable).
country_codeISO country code.
countryFull country name.
domainCompany domain name.
last_funding_roundMost recent funding round (e.g., Seed, Pre Seed etc)
Sample Response
{
    "status": "success",
    "data": [
        {
            "name": "Wokelo AI",
            "permalink": "wokelo-ai",
            "short_description": "Wokelo builds purpose-built AI agents for dealmaking and consulting, designed by domain-experts to power sourcing, diligence and strategy.",
            "founded_year": "2023",
            "ipo_status": "private",
            "hq": "Seattle, United States",
            "industries": "AI Investment Research Platform",
            "website": "https://www.wokelo.ai/",
            "ticker": "",
            "country_code": "US",
            "country": "United States",
            "domain": "wokelo.ai",
            "last_funding_round": "Seed"
        }
    ],
    "count": 10
}
const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer Token");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "q": "wokelo"
});

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("{{path}}/api/enterprise/company/search?query=wokelo&search_by=name&company_type=all", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
{
    "status": "success",
    "data": [
        {
            "name": "Wokelo AI",
            "permalink": "wokelo-ai",
            "short_description": "Wokelo builds purpose-built AI agents for dealmaking and consulting.",
            "founded_year": "2023",
            "ipo_status": "private",
            "hq": "Seattle, United States",
            "industries": "AI Investment Research Platform",
            "website": "https://www.wokelo.ai/",
            "ticker": "",
            "country_code": "US",
            "country": "United States",
            "domain": "wokelo.ai",
            "last_funding_round": "Seed"
        }
    ],
    "count": 10
}