Skip to content

Lookup companies

Request

Find companies by LinkedIn ID, website URL, or name. Pass an array of lookup criteria — each item should contain at least one identifier.

Security
bearerAuth
Bodyapplication/jsonrequired
lookupsArray of objectsrequired
POST
/leads/api/companies/lookup
curl -i -X POST \
  https://leadgen.grinfi.io/leads/api/companies/lookup \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "lookups": [
      {
        "linkedin": "acme-inc"
      },
      {
        "website": "acme.com"
      }
    ]
  }'

Responses

Matching companies.

Bodyapplication/json
Array [
uuidstring
Example:"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
team_idinteger
user_idinteger or null
data_source_uuidstring or null
lead_status_uuidstring or null

Pipeline stage UUID.

namestring
Example:"Acme Inc"
domainstring or null
Example:"acme.com"
websitestring or null
Example:"https://acme.com"
ln_idinteger or null

LinkedIn company numeric ID.

linkedinstring or null
Example:"acme-inc"
facebookstring or null
twitterstring or null
phonestring or null
hq_raw_addressstring or null
Example:"San Francisco, CA, USA"
hq_locationArray of objects or null
logo_urlstring or null
industrystring or null
Example:"Technology"
employees_rangestring or null
Example:"51-200"
year_establishedinteger or null
Example:2015
aboutstring or null
listsArray of strings or null

List UUIDs.

tagsArray of strings or null

Tag UUIDs.

statusstring
last_enrich_atstring or null, (date-time)
created_atstring or null, (date-time)
updated_atstring or null, (date-time)
]
Response
[
  {
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "team_id": 0,
    "user_id": 0,
    "data_source_uuid": "string",
    "lead_status_uuid": "string",
    "name": "Acme Inc",
    "domain": "acme.com",
    "website": "https://acme.com",
    "ln_id": 0,
    "linkedin": "acme-inc",
    "facebook": "string",
    "twitter": "string",
    "phone": "string",
    "hq_raw_address": "San Francisco, CA, USA",
    "hq_location": [ … ],
    "logo_url": "string",
    "industry": "Technology",
    "employees_range": "51-200",
    "year_established": 2015,
    "about": "string",
    "lists": [ … ],
    "tags": [ … ],
    "status": "string",
    "last_enrich_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
]