Get Employees | Aviato API

import requests
url = "https://data.api.aviato.co/company/employees"
querystring = {"perPage":"100","page":"1"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "employees": [
    {
      "person": {
        "id": "id",
        "fullName": "fullName",
        "firstName": "firstName",
        "lastName": "lastName",
        "entityType": "person",
        "location": "location",
        "URLs": {
          "golden": "golden",
          "contact": "contact",
          "twitter": "twitter",
          "website": "website",
          "facebook": "facebook",
          "linkedin": "linkedin",
          "pitchbook": "pitchbook",
          "angelList": "angelList",
          "signalNFX": "signalNFX",
          "crunchbase": "crunchbase"
        }
      },
      "personID": "personID",
      "positionList": [
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description"
        },
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description"
        }
      ],
      "companyID": "companyID",
      "companyName": "companyName",
      "endDate": "2024-01-15T09:30:00Z",
      "entityType": "person",
      "linkedinID": "linkedinID",
      "linkedinNumID": "linkedinNumID",
      "startDate": "2024-01-15T09:30:00Z"
    },
    {
      "person": {
        "id": "id",
        "fullName": "fullName",
        "firstName": "firstName",
        "lastName": "lastName",
        "entityType": "person",
        "location": "location",
        "URLs": {
          "golden": "golden",
          "contact": "contact",
          "twitter": "twitter",
          "website": "website",
          "facebook": "facebook",
          "linkedin": "linkedin",
          "pitchbook": "pitchbook",
          "angelList": "angelList",
          "signalNFX": "signalNFX",
          "crunchbase": "crunchbase"
        }
      },
      "personID": "personID",
      "positionList": [
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description"
        },
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description"
        }
      ],
      "companyID": "companyID",
      "companyName": "companyName",
      "endDate": "2024-01-15T09:30:00Z",
      "entityType": "person",
      "linkedinID": "linkedinID",
      "linkedinNumID": "linkedinNumID",
      "startDate": "2024-01-15T09:30:00Z"
    }
  ],
  "pages": 1,
  "totalResults": 1
}

Get the employees of the specified company.

Authentication

AuthorizationBearer

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

Query parameters

idstringOptional

linkedinIDstringOptional

linkedinNumIDstringOptional

linkedinURLstringOptional

LinkedIn URL, accepts company URLs like linkedin.com/company/google or linkedin.com/company/1441

facebookIDstringOptional

twitterIDstringOptional

crunchbaseIDstringOptional

pitchbookIDstringOptional

producthuntIDstringOptional

dealroomIDstringOptional

goldenIDstringOptional

angellistIDstringOptional

wellfoundIDstringOptional

websitestringOptional

perPageintegerRequired0-100

Number of items per page.

pageintegerRequired

Page number, starts from 0.

Response

This endpoint returns an object.

employeeslist of objects

pagesinteger

totalResultsinteger

Errors

400

Bad Request Error

401

Unauthorized Error

404

Company Not Found Error

429

Rate Limit Error