POST
/
company-api
/
companies
/
search
Search companies
curl --request POST \
  --url https://app.arxena.com/company-api/companies/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "companyName": "Acme",
  "dataSource": "auto",
  "limit": 10
}
'
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({companyName: 'Acme', dataSource: 'auto', limit: 10})
};

fetch('https://app.arxena.com/company-api/companies/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
import requests

url = "https://app.arxena.com/company-api/companies/search"

payload = {
    "companyName": "Acme",
    "dataSource": "auto",
    "limit": 10
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "status": "ok",
  "dataSource": "index",
  "total": 1,
  "items": [
    {
      "id": "acme",
      "name": "Acme",
      "website": "acme.com",
      "linkedinUrl": "https://www.linkedin.com/company/acme",
      "industry": "Software"
    }
  ]
}
Pass companyName, keywords, query, website, industry, location, or a LinkedIn url (Sales Navigator account list, company search, or people search). Omit dataSource or pass auto to resolve LinkedIn Unipile automatically (Sales Navigator seat first), then Harvest, then the companies index. Pin index, unipile, pool, recruiter, or harvest when you do not want that auto-resolve. Account-list URLs also accept useV2; Unipile v2 browse always returns newest-added first. Each hit is a standard company record: id, name, website, linkedinUrl, industry. 
curl --request POST \
  --url https://app.arxena.com/company-api/companies/search \
  --header 'Authorization: Bearer YOUR_API_KEY_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "companyName": "Acme",
    "dataSource": "auto",
    "limit": 10
  }'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
dataSource
enum<string>

auto prefers Unipile Sales Navigator, then Recruiter/classic, Harvest, then index.

Available options:
auto,
index,
harvest,
unipile,
pool,
recruiter
Example:

"auto"

​
accountId
string
​
query
string
​
keywords
string
​
companyName
string
Example:

"Acme"

​
website
string
​
industry
string
​
location
string
​
url
string

LinkedIn URL. Sales Navigator account lists (/sales/accounts/dashboard?listId=...) are parsed and searched with v1 account_lists unless useV2 is true (or UNIPILE_ACCOUNT_LIST_V2=true), which browses the list via Unipile v2 sorted by date added descending. Other LinkedIn search URLs are sent as Unipile search-from-URL.

Example:

"https://www.linkedin.com/sales/accounts/dashboard?listGroup=CUSTOM_LISTS&listId=7378394885466337283"

​
useV2
boolean

When true, Sales Navigator account-list URLs use Unipile v2 browse (always newest first). When omitted, UNIPILE_ACCOUNT_LIST_V2 is the default (false).

Example:

false

​
limit
number
default:20
Required range: 1 <= x <= 100

Response

200 - application/json

Company search hits

​
status
enum<string>
Available options:
ok
​
dataSource
enum<string>
Available options:
index,
harvest,
unipile,
pool,
recruiter
​
unipileProduct
string
​
total
integer
​
items
object[]