Enrich Layer API

https://enrichlayer.com/docs/api/v2
Admin
Enrich Layer API is a platform that provides comprehensive data enrichment and lookup services for...
Tokens:56,037
Snippets:155
Trust Score:6
Update:6 months ago
Show doc for...
Tokens:
Raw
### Company Data Response Example

Source: https://enrichlayer.com/docs/api/v2/company-api/company-profile

This is an example of a successful JSON response when fetching company data. It includes details such as description, industry, location, and more.

```json
{
  "linkedin_internal_id": "1441",
  "description": "A problem isn't truly solved until it's solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\nCheck out our career opportunities at careers.google.com.",
  "website": "https://goo.gle/3m1IN7m",
  "industry": "Software Development",
  "company_size": [
    10001,
    null
  ],
  "company_size_on_linkedin": 319856,
  "hq": {
    "country": "US",
    "city": "Mountain View",
    "postal_code": "94043",
    "line_1": "1600 Amphitheatre Parkway",
    "is_hq": true,
    "state": "CA"
  },
  "company_type": "PUBLIC_COMPANY",
  "founded_year": null,
  "specialities": [
    "search",
    "ads"
  ],
  "locations": [
    {
      "country": "US",
      "city": "Mountain View",
      "postal_code": "94043",
      "line_1": "1600 Amphitheatre Parkway",
      "is_hq": true,
      "state": "CA"
    },
    {
      "country": "US",
      "city": "New York",
      "postal_code": "10011",
      "line_1": "111 8th Ave",
      "is_hq": false,
      "state": "NY"
    }
  ],
  "name": "Google",
  "tagline": null,
  "universal_name_id": "google",
  "profile_pic_url": "https://assets.enrichlayer.com/pp/வுகளை",
  "background_cover_image_url": "https://assets.enrichlayer.com/pp/backgrounds/google-cover.jpg",
  "search_id": "1441",
  "similar_companies": [
    {
      "name": "Amazon",
      "link": "https://www.linkedin.com/company/amazon",
      "industry": "Software Development",
      "location": "Seattle, WA"
    },
    {
      "name": "Microsoft",
      "link": "https://www.linkedin.com/company/microsoft",
      "industry": "Software Development",
      "location": "Redmond, Washington"
    }
  ],
  "affiliated_companies": [
    {
      "name": "YouTube",
      "link": "https://www.linkedin.com/company/youtube",
      "industry": "Software Development",
      "location": "San Bruno, CA"
    },
    {
      "name": "Google Cloud",
      "link": "https://www.linkedin.com/showcase/google-cloud",
      "industry": "Software Development",
      "location": "Mountain View, California"
    }
  ],
  "updates": [
    {
      "article_link": null,
      "image": "https://assets.enrichlayer.com/pp/profilepic/57ef9922f8484ada3bd6001d1c68afa1",
      "posted_on": {
        "day": 13,
        "month": 9,
        "year": 2022
      },
      "text": "Want to kick start your #LifeAtGoogle but not sure where to begin? Explore our Build Your Future site, where you can learn about developmental programs, learn tips for future interviews, sign up for informational events, and even hear real stories from Googlers who’ve been where you are now. Get started → https://bit.ly/3SKPzQB",
      "total_likes": 4267
    },
    {
      "article_link": null,
      "image": "https://assets.enrichlayer.com/pp/profilepic/57ef9922f8484ada3bd6001d1c68afa1",
      "posted_on": null,
      "text": "Ariana, welcome to Google. Here’s to a year full of growth, learning, and experiences at #LifeAtGoogle! 🎉",
      "total_likes": 397
    }
  ],
  "follower_count": 27472792,
  "meta": {
    "thin_profile": false,
    "last_updated": "2023-10-26T11:34:30Z"
  }
}
```

--------------------------------

### Personal Email Lookup Response Example

Source: https://enrichlayer.com/docs/api/v2/contact-api/personal-email-lookup

Example JSON response from the Personal Email Lookup endpoint, showing found emails and invalid emails.

```json
{
  "emails": [
    "bill.gates@gatesfoundation.org",
    "billg@microsoft.com",
    "billgates@hotmail.com"
  ],
  "invalid_emails": []
}
```

--------------------------------

### School Profile JSON Response Example

Source: https://enrichlayer.com/docs/api/v2/school-api/school-profile

This is an example of the JSON response you can expect when successfully retrieving a school profile. It includes details such as the school's ID, description, website, industry, and more.

```json
{
  "linkedin_internal_id": "1503",
  "description": "The Massachusetts Institute of Technology (MIT) is a private research university located in Cambridge, Massachusetts. MIT is devoted to the advancement of knowledge and education of students in areas that contribute to or prosper in an environment of science and technology.",
  "website": "http://web.mit.edu/",
  "industry": "Higher Education",
  "company_size": [
    5001,
    10000
  ],
  "company_size_on_linkedin": 23329,
  "hq": {
    "country": "US",
    "city": "Cambridge, MA",
    "postal_code": "02139-4307",
    "line_1": "77 Massachusetts Avenue",
    "is_hq": true,
    "state": "Massachusetts"
  },
  "company_type": "EDUCATIONAL_INSTITUTION",
  "founded_year": 1861,
  "specialities": [
    "education",
    "science",
    "research",
    "engineering"
  ],
  "locations": [
    {
      "country": "US",
      "city": "Cambridge",
      "postal_code": "02139",
      "line_1": "Massachusetts Ave",
      "is_hq": true,
      "state": "Massachusetts"
    }
  ],
  "name": "Massachusetts Institute of Technology",
  "tagline": null,
  "universal_name_id": "mit",
  "profile_pic_url": "https://assets.enrichlayer.com/pp/profilepic/35d64df1cce08965de8b857ecc88d2ff",
  "background_cover_image_url": null,
  "search_id": "1503",
  "similar_companies": [
    {
      "name": "MIT Sloan School of Management",
      "link": "https://www.linkedin.com/school/mitsloan/",
      "industry": "Higher Education",
      "location": null
    },
    {
      "name": "MIT School of Engineering",
      "link": "https://www.linkedin.com/school/mit-school-of-engineering/",
      "industry": "Higher Education",
      "location": null
    }
  ],
  "affiliated_companies": [],
  "updates": [],
  "follower_count": 539321,
  "meta": {
    "thin_profile": false,
    "last_updated": "2023-10-26T11:34:30Z"
  }
}
```

--------------------------------

### Personal Email Lookup cURL Example

Source: https://enrichlayer.com/docs/api/v2/contact-api/personal-email-lookup

Example of how to call the Personal Email Lookup endpoint using cURL. Includes parameters for profile URL, email validation, and page size.

```bash
curl -X GET "https://enrichlayer.com/api/v2/contact-api/personal-email?profile_url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates&twitter_profile_url=https%3A%2F%2Fx.com%2Fenrichlayer&facebook_profile_url=https%3A%2F%2Fwww.facebook.com%2Fzuck&email_validation=include&page_size=0"
```

--------------------------------

### Personal Contact Number Lookup Response Example

Source: https://enrichlayer.com/docs/api/v2/contact-api/personal-contact-number-lookup

This is an example of a successful JSON response from the personal contact number lookup endpoint. It contains a list of found phone numbers.

```json
{
  "numbers": [
    "+19707495020"
  ]
}
```

--------------------------------

### Company ID Lookup Response Body Example

Source: https://enrichlayer.com/docs/api/v2/company-api/company-id-lookup

This is an example of a successful JSON response when looking up a company by its ID. It contains the 'vanity_id' of the company.

```json
{
  "vanity_id": "google"
}
```

--------------------------------

### Personal Contact Number Lookup cURL Example

Source: https://enrichlayer.com/docs/api/v2/contact-api/personal-contact-number-lookup

Use this cURL command to perform a GET request to the personal contact number lookup endpoint. Ensure you replace the placeholder Authorization token with your actual Bearer token. The `page_size` parameter can be used to limit the number of results.

```curl
curl -X GET "https://enrichlayer.com/api/v2/contact-api/personal-contact?profile_url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates&twitter_profile_url=https%3A%2F%2Fx.com%2Fenrichlayer&facebook_profile_url=https%3A%2F%2Fwww.facebook.com%2Fzuck&page_size=0" \
  -H "Authorization: "
```

--------------------------------

### Employee Listing Response Format

Source: https://enrichlayer.com/docs/api/v2/company-api/employee-listing

Example JSON response structure returned by the company employees endpoint.

```json
{
  "employees": [
    {
      "profile_url": "https://www.linkedin.com/in/williamhgates",
      "profile": {
        "public_identifier": "williamhgates",
        "profile_pic_url": "https://assets.enrichlayer.com/pp/profilepic/a41217d5753de1f3f4906f9da43dbad6",
        "background_cover_image_url": null,
        "first_name": "Bill",
        "last_name": "Gates",
        "full_name": "Bill Gates",
        "occupation": "Co-chair at Bill & Melinda Gates Foundation",
        "headline": "Co-chair, Bill & Melinda Gates Foundation",
        "summary": "Co-chair of the Bill & Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
        "country": "US",
        "country_full_name": "United States of America",
        "city": "Seattle",
        "state": "Washington",
        "experiences": [
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 2015
            },
            "ends_at": null,
            "company": "Breakthrough Energy ",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/breakthrough-energy/",
            "title": "Founder",
            "description": null,
            "location": null,
            "logo_url": "https://assets.enrichlayer.com/ll/D560BAQFRMYiQN7-2kA/company-logo_100_100/B56ZoI4SGPI0AQ-/0/1761085563539/breakthrough_energy_logo?e=2147483647&v=beta&t=J6RbEvs17fl1uiEaXQm0hmXy4imx36mV_Hu80JcR1DE"
          },
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 2000
            },
            "ends_at": null,
            "company": "Bill & Melinda Gates Foundation",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/bill-&-melinda-gates-foundation/",
            "title": "Co-chair",
            "description": null,
            "location": null,
            "logo_url": "https://assets.enrichlayer.com/ll/D560BAQEgMqqFTd40Tg/company-logo_100_100/company-logo_100_100/0/1736784969376/bill__melinda_gates_foundation_logo?e=2147483647&v=beta&t=2JH2cMcZms60vPAMbvVZyMeYXosQ1Jjy5axDlyeQ1Ww"
          }
        ],
        "education": [
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 1973
            },
            "ends_at": {
              "day": 31,
              "month": 12,
              "year": 1975
            },
            "field_of_study": null,
            "degree_name": null,
            "school": "Harvard University",
            "school_linkedin_profile_url": null,
            "description": null,
            "logo_url": "https://assets.enrichlayer.com/pp/profilepic/518005a5a755bd1d2fde90f216039bbc"
          },
          {
            "starts_at": null,
            "ends_at": null,
            "field_of_study": null,
            "degree_name": null,
            "school": "Lakeside School",
            "school_linkedin_profile_url": null,
            "description": null,
            "logo_url": "https://assets.enrichlayer.com/pp/profilepic/f0d32d5de696536e8b46133cb042250a"
          }
        ],
        "languages": [],
        "accomplishment_organisations": [],
        "accomplishment_publications": [],
        "accomplishment_honors_awards": [],
        "accomplishment_patents": [],
        "accomplishment_courses": [],
        "accomplishment_projects": [],
        "accomplishment_test_scores": [],
        "volunteer_work": [],
        "certifications": [],
        "connections": null,
        "people_also_viewed": [],
        "recommendations": [],
        "activities": [],
        "similarly_named_profiles": [],
        "articles": [],
        "groups": []
      },
      "last_updated": "2023-10-26T11:34:30Z"
    }
  ],
  "next_page": null
}
```

--------------------------------

### Employee Search Response Format

Source: https://enrichlayer.com/docs/api/v2/company-api/employee-search

Example JSON response structure returned by the employee search endpoint.

```json
{
  "employees": [
    {
      "profile_url": "https://www.linkedin.com/in/satyanadella",
      "profile": {
        "public_identifier": "williamhgates",
        "profile_pic_url": "https://assets.enrichlayer.com/pp/profilepic/a41217d5753de1f3f4906f9da43dbad6",
        "background_cover_image_url": null,
        "first_name": "Bill",
        "last_name": "Gates",
        "full_name": "Bill Gates",
        "occupation": "Co-chair at Bill & Melinda Gates Foundation",
        "headline": "Co-chair, Bill & Melinda Gates Foundation",
        "summary": "Co-chair of the Bill & Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
        "country": "US",
        "country_full_name": "United States of America",
        "city": "Seattle",
        "state": "Washington",
        "experiences": [
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 2015
            },
            "ends_at": null,
            "company": "Breakthrough Energy ",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/breakthrough-energy/",
            "title": "Founder",
            "description": null,
            "location": null,
            "logo_url": "https://assets.enrichlayer.com/ll/D560BAQFRMYiQN7-2kA/company-logo_100_100/B56ZoI4SGPI0AQ-/0/1761085563539/breakthrough_energy_logo?e=2147483647&v=beta&t=J6RbEvs17fl1uiEaXQm0hmXy4imx36mV_Hu80JcR1DE"
          },
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 2000
            },
            "ends_at": null,
            "company": "Bill & Melinda Gates Foundation",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/bill-&-melinda-gates-foundation/",
            "title": "Co-chair",
            "description": null,
            "location": null,
            "logo_url": "https://assets.enrichlayer.com/ll/D560BAQEgMqqFTd40Tg/company-logo_100_100/company-logo_100_100/0/1736784969376/bill__melinda_gates_foundation_logo?e=2147483647&v=beta&t=2JH2cMcZms60vPAMbvVZyMeYXosQ1Jjy5axDlyeQ1Ww"
          }
        ],
        "education": [
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 1973
            },
            "ends_at": {
              "day": 31,
              "month": 12,
              "year": 1975
            },
            "field_of_study": null,
            "degree_name": null,
            "school": "Harvard University",
            "school_linkedin_profile_url": null,
            "description": null,
            "logo_url": "https://assets.enrichlayer.com/pp/profilepic/518005a5a755bd1d2fde90f216039bbc"
          },
          {
            "starts_at": null,
            "ends_at": null,
            "field_of_study": null,
            "degree_name": null,
            "school": "Lakeside School",
            "school_linkedin_profile_url": null,
            "description": null,
            "logo_url": "https://assets.enrichlayer.com/pp/profilepic/f0d32d5de696536e8b46133cb042250a"
          }
        ],
        "languages": [],
        "accomplishment_organisations": [],
        "accomplishment_publications": [],
        "accomplishment_honors_awards": [],
        "accomplishment_patents": [],
        "accomplishment_courses": [],
        "accomplishment_projects": [],
        "accomplishment_test_scores": [],
        "volunteer_work": [],
        "certifications": [],
        "connections": null,
        "people_also_viewed": [],
        "recommendations": [],
        "activities": [],
        "similarly_named_profiles": [],
        "articles": [],
        "groups": []
      },
      "last_updated": "2023-10-26T11:34:30Z"
    }
  ],
  "next_page": null
}
```

--------------------------------

### View Credit Balance Endpoint

Source: https://enrichlayer.com/docs/api/v2/customer-api/customer-listing-count

Get your current credit balance.

```APIDOC
## GET /api/v2/credits/balance/

### Description
Get your current credit balance.

### Method
GET

### Endpoint
`/api/v2/credits/balance/`

### Response
#### Success Response (200)
- **balance** (integer) - The current credit balance.

#### Response Example
```json
{
  "balance": 1000
}
```
```

--------------------------------

### GET /api/v2/school/students/

Source: https://enrichlayer.com/docs/api/v2/school-api/student-listing

Retrieves a list of student profiles for a given school, with various filtering and sorting options.

```APIDOC
## GET /api/v2/school/students/

### Description
Retrieves a list of student profiles for a given school. This endpoint allows for filtering by country, enrichment status, search keywords, student status, and sorting by matriculation date. It also supports pagination and resolving numeric IDs.

### Method
GET

### Endpoint
/api/v2/school/students/

### Parameters
#### Query Parameters
- **school_url** (string) - Required - The LinkedIn URL of the school.
- **country** (string) - Optional - The country code to filter students by (e.g., 'us').
- **enrich_profiles** (string) - Optional - Whether to enrich profiles ('enrich' or 'no_enrich').
- **search_keyword** (string) - Optional - Keywords to search for within student profiles. Supports wildcards and OR conditions (e.g., 'computer*%7Ccs').
- **page_size** (integer) - Optional - The number of results to return per page. Defaults to 10.
- **student_status** (string) - Optional - Filter students by their status (e.g., 'current', 'alumni').
- **sort_by** (string) - Optional - The field to sort the results by (e.g., 'recently_matriculated').
- **resolve_numeric_id** (boolean) - Optional - Whether to resolve numeric IDs to their string representations. Defaults to false.

### Request Example
```json
{
  "example": "curl -X GET \"https://enrichlayer.com/api/v2/school/students/?school_url=https%3A%2F%2Fwww.linkedin.com%2Fschool%2Fstanford-university&country=us&enrich_profiles=enrich&search_keyword=computer*%7Ccs&page_size=10&student_status=current&sort_by=recently-matriculated&resolve_numeric_id=false\" \
  -H \"Authorization: \""
}
```

### Response
#### Success Response (200)
- **students** (array) - A list of student profile objects.
  - **profile_url** (string) - The LinkedIn profile URL of the student.
  - **profile** (object) - Detailed profile information.
    - **public_identifier** (string) - The public identifier of the LinkedIn profile.
    - **profile_pic_url** (string) - URL of the student's profile picture.
    - **background_cover_image_url** (string) - URL of the student's background cover image.
    - **first_name** (string) - The first name of the student.
    - **last_name** (string) - The last name of the student.
    - **full_name** (string) - The full name of the student.
    - **follower_count** (integer) - The number of followers the student has.
    - **occupation** (string) - The current occupation of the student.
    - **headline** (string) - The student's headline.
    - **summary** (string) - A summary of the student's profile.
    - **country** (string) - The country of the student.
    - **country_full_name** (string) - The full name of the student's country.
    - **city** (string) - The city where the student is located.
    - **state** (string) - The state where the student is located.
    - **experiences** (array) - A list of the student's work experiences.
      - **starts_at** (object) - The start date of the experience.
        - **day** (integer) - Day of the start date.
        - **month** (integer) - Month of the start date.
        - **year** (integer) - Year of the start date.
      - **ends_at** (object | null) - The end date of the experience.
        - **day** (integer) - Day of the end date.
        - **month** (integer) - Month of the end date.
        - **year** (integer) - Year of the end date.
      - **company** (string) - The name of the company.
      - **company_linkedin_profile_url** (string) - LinkedIn URL of the company.
      - **company_facebook_profile_url** (string | null) - Facebook URL of the company.
      - **title** (string) - The job title.
      - **description** (string | null) - Description of the role.
      - **location** (string) - The location of the experience.
      - **logo_url** (string) - URL of the company logo.
    - **education** (array) - A list of the student's educational background.
      - **starts_at** (object) - The start date of the education.
        - **day** (integer | null) - Day of the start date.
        - **month** (integer | null) - Month of the start date.
        - **year** (integer | null) - Year of the start date.
      - **ends_at** (object | null) - The end date of the education.
        - **day** (integer | null) - Day of the end date.
        - **month** (integer | null) - Month of the end date.
        - **year** (integer | null) - Year of the end date.
      - **field_of_study** (string | null) - The field of study.
      - **degree_name** (string | null) - The name of the degree.
      - **school** (string) - The name of the school.
      - **school_linkedin_profile_url** (string) - LinkedIn URL of the school.
      - **school_facebook_profile_url** (string | null) - Facebook URL of the school.
      - **description** (string | null) - Description of the education.
      - **logo_url** (string) - URL of the school logo.
      - **grade** (string | null) - The grade obtained.
      - **activities_and_societies** (string | null) - Activities and societies.

#### Response Example
```json
{
  "students": [
    {
      "profile_url": "https://www.linkedin.com/in/satyanadella",
      "profile": {
        "public_identifier": "satyanadella",
        "profile_pic_url": "https://assets.enrichlayer.com/pp/profilepic/7d369850c9fe8c35e78a6a50c75334f5",
        "background_cover_image_url": "https://assets.enrichlayer.com/pp/profilepic/fe878f911fecd238e169a23b12103b0e",
        "first_name": "Satya",
        "last_name": "Nadella",
        "full_name": "Satya Nadella",
        "follower_count": 11888127,
        "occupation": "Chairman and CEO at Microsoft",
        "headline": "Chairman and CEO at Microsoft",
        "summary": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
        "country": "US",
        "country_full_name": "United States of America",
        "city": "Redmond",
        "state": "Washington",
        "experiences": [
          {
            "starts_at": {
              "day": 1,
              "month": 2,
              "year": 2014
            },
            "ends_at": null,
            "company": "Microsoft",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/microsoft",
            "company_facebook_profile_url": null,
            "title": "Chairman and CEO",
            "description": null,
            "location": "Greater Seattle Area",
            "logo_url": "https://assets.enrichlayer.com/ll/D560BAQH32RJQCl3dDQ/company-logo_100_100/B56ZYQ0mrGGoAU-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=rr_7_bFRKp6umQxIHErPOZHtR8dMPIYeTjlKFdotJBY"
          }
        ],
        "education": [
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 1994
            },
            "ends_at": {
              "day": 31,
              "month": 12,
              "year": 1996
            },
            "field_of_study": null,
            "degree_name": null,
            "school": "The University of Chicago Booth School of Business",
            "school_linkedin_profile_url": "https://www.linkedin.com/company/universityofchicagoboothschoolofbusiness",
            "school_facebook_profile_url": null,
            "description": null,
            "logo_url": "https://assets.enrichlayer.com/pp/profilepic/88fa467a62fbfc5325394253f14e8700",
            "grade": null,
            "activities_and_societies": null
          }
        ]
      }
    }
  ]
}
```
```

--------------------------------

### Company Role and Profile Data Example

Source: https://enrichlayer.com/docs/api/v2/people-api/role-lookup

This JSON object represents the detailed profile information for a company role, including personal details, experience, and education.

```JSON
{
  "linkedin_profile_url": "https://www.linkedin.com/in/kevinolearytv",
  "profile": {
    "public_identifier": "satyanadella",
    "profile_pic_url": "https://assets.enrichlayer.com/pp/profilepic/7d369850c9fe8c35e78a6a50c75334f5",
    "background_cover_image_url": "https://assets.enrichlayer.com/pp/profilepic/fe878f911fecd238e169a23b12103b0e",
    "first_name": "Satya",
    "last_name": "Nadella",
    "full_name": "Satya Nadella",
    "follower_count": 11888127,
    "occupation": "Chairman and CEO at Microsoft",
    "headline": "Chairman and CEO at Microsoft",
    "summary": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
    "country": "US",
    "country_full_name": "United States of America",
    "city": "Redmond",
    "state": "Washington",
    "experiences": [
      {
        "starts_at": {
          "day": 1,
          "month": 2,
          "year": 2014
        },
        "ends_at": null,
        "company": "Microsoft",
        "company_linkedin_profile_url": "https://www.linkedin.com/company/microsoft",
        "company_facebook_profile_url": null,
        "title": "Chairman and CEO",
        "description": null,
        "location": "Greater Seattle Area",
        "logo_url": "https://assets.enrichlayer.com/ll/D560BAQH32RJQCl3dDQ/company-logo_100_100/B56ZYQ0mrGGoAU-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=rr_7_bFRKp6umQxIHErPOZHtR8dMPIYeTjlKFdotJBY"
      },
      {
        "starts_at": {
          "day": 1,
          "month": 1,
          "year": 2018
        },
        "ends_at": null,
        "company": "University of Chicago",
        "company_linkedin_profile_url": "https://www.linkedin.com/company/uchicago",
        "company_facebook_profile_url": null,
        "title": "Member Board Of Trustees",
        "description": null,
        "location": null,
        "logo_url": "https://assets.enrichlayer.com/pp/profilepic/f40c5f31ef246aeb1000ffb4e40f2991"
      },
      {
        "starts_at": {
          "day": 1,
          "month": 1,
          "year": 2017
        },
        "ends_at": {
          "day": 31,
          "month": 12,
          "year": 2024
        },
        "company": "Starbucks",
        "company_linkedin_profile_url": "https://www.linkedin.com/company/starbucks",
        "company_facebook_profile_url": null,
        "title": "Board Member",
        "description": null,
        "location": null,
        "logo_url": "https://assets.enrichlayer.com/ll/C4D0BAQEQxk9y2rk7Hw/company-logo_100_100/company-logo_100_100/0/1631316692276?e=2147483647&v=beta&t=itdoVXP3gnqtQ7Grar4B3YoPyw-Ors9bKMZlZpb0QcY"
      }
    ],
    "education": [
      {
        "starts_at": {
          "day": 1,
          "month": 1,
          "year": 1994
        },
        "ends_at": {
          "day": 31,
          "month": 12,
          "year": 1996
        },
        "field_of_study": null,
        "degree_name": null,
        "school": "The University of Chicago Booth School of Business",
        "school_linkedin_profile_url": "https://www.linkedin.com/company/universityofchicagoboothschoolofbusiness",
        "school_facebook_profile_url": null,
        "description": null,
        "logo_url": "https://assets.enrichlayer.com/pp/profilepic/88fa467a62fbfc5325394253f14e8700",
        "grade": null,
        "activities_and_societies": null
      },
      {
        "starts_at": {
          "day": null,
          "month": null,
          "year": null
        },
        "ends_at": null,
        "field_of_study": "Electrical Engineering",
        "degree_name": "Bachelor’s Degree",
        "school": "Manipal Institute of Technology, Manipal",
        "school_linkedin_profile_url": "https://www.linkedin.com/company/manipal-institute-of-technology",
        "school_facebook_profile_url": null,
        "description": null,
        "logo_url": "https://assets.enrichlayer.com/pp/profilepic/2aef6f72c73e3b40dbd56163897bdc04",
        "grade": null,
        "activities_and_societies": null
      },
      {
        "starts_at": {
          "day": null,
          "month": null,
          "year": null
        },
        "ends_at": null,
        "field_of_study": "Computer Science",
        "degree_name": "Master’s Degree",
        "school": "University of Wisconsin-Milwaukee",
        "school_linkedin_profile_url": "https://www.linkedin.com/company/uwmilwaukee",
        "school_facebook_profile_url": null,
        "description": null,
        "logo_url": "https://assets.enrichlayer.com/pp/profilepic/7916094135030c5846f34230e03dbaa2",
        "grade": null,
        "activities_and_societies": null
      }
    ],
    "accomplishment_organisations": [],
    "accomplishment_publications": []
  }
}
```

--------------------------------

### Job Search Endpoint Request (cURL)

Source: https://enrichlayer.com/docs/api/v2/jobs-api/job-search

Example of a cURL request to the Job Search Endpoint with various query parameters.

```bash
curl -X GET "https://enrichlayer.com/api/v2/company/job?job_type=full-time&experience_level=mid_senior_level&when=past-month&flexibility=remote&geo_id=92000000&keyword=engineer&search_id=1035"
```

--------------------------------

### GET /api/v2/profile

Source: https://enrichlayer.com/docs/api/v2/people-api/person-profile

Retrieves structured data of a Person Profile.

```APIDOC
## GET /api/v2/profile

### Description
Get structured data of a Person Profile. Each successful request costs 1 credit.

### Method
GET

### Endpoint
https://enrichlayer.com/api/v2/profile

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - BearerAuth client (Bearer <token>)
```

--------------------------------

### Get School Students Data via cURL

Source: https://enrichlayer.com/docs/api/v2/school-api/student-listing

Use this cURL command to fetch student data for a specific school. Ensure to replace placeholder values and include your authorization token.

```bash
curl -X GET "https://enrichlayer.com/api/v2/school/students/?school_url=https%3A%2F%2Fwww.linkedin.com%2Fschool%2Fstanford-university&country=us&enrich_profiles=enrich&search_keyword=computer*%7Ccs&page_size=10&student_status=current&sort_by=recently-matriculated&resolve_numeric_id=false" \
  -H "Authorization: "
```

--------------------------------

### Employee Listing Endpoint

Source: https://enrichlayer.com/docs/api/v2/company-api/employee-count

Get a list of employees of a Company.

```APIDOC
## GET /api/v2/company/employees

### Description
Get a list of employees of a Company.

### Method
GET

### Endpoint
`/api/v2/company/employees`

### Parameters
#### Query Parameters
- **company_url** (string) - Required - The URL of the company.

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **[Fields will be documented here based on actual response structure]**

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Retrieve customer list via cURL

Source: https://enrichlayer.com/docs/api/v2/customer-api/customer-listing

Use this cURL command to fetch customer data by providing company profile URLs and page size.

```bash
curl -X GET "https://enrichlayer.com/api/v2/customers?company_profile_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fwatsons&twitter_profile_url=https%3A%2F%2Fx.com%2Fwatsonsproperty&page_size=10"
```

--------------------------------

### GET /person/profile-picture

Source: https://enrichlayer.com/docs/api/v2/people-api/person-profile

Retrieves the profile picture of a person from cached profiles.

```APIDOC
## GET /person/profile-picture

### Description
Get the profile picture of a person. Returns profile pictures from cached people profiles.

### Method
GET

### Endpoint
/person/profile-picture

### Response
#### Success Response (200)
- **image_url** (string) - The URL of the profile picture.

### Cost
0 credits / successful request
```

--------------------------------

### Retrieve Job Count via cURL

Source: https://enrichlayer.com/docs/api/v2/jobs-api/jobs-listing-count

Example request to the jobs count endpoint using cURL with various query parameters.

```bash
curl -X GET "https://enrichlayer.com/api/v2/company/job/count?job_type=full-time&experience_level=mid_senior_level&when=past-month&flexibility=remote&geo_id=92000000&keyword=engineer&search_id=1035"
```

--------------------------------

### GET /company-id-lookup

Source: https://enrichlayer.com/docs/api/v2/people-api/role-lookup

Look up the vanity ID of a company by its numeric ID.

```APIDOC
## GET /company-id-lookup

### Description
Look up the vanity ID of a company by its numeric ID.

### Method
GET

### Endpoint
/company-id-lookup
```

--------------------------------

### API Resources

Source: https://enrichlayer.com/docs/api/v2

Browse the API by resource type using the sidebar navigation.

```APIDOC
## Resources

Browse the API by resource type using the sidebar navigation.
```

--------------------------------

### GET /person-profile

Source: https://enrichlayer.com/docs/api/v2/people-api/role-lookup

Retrieves structured data for a specific person profile.

```APIDOC
## GET /person-profile

### Description
Get structured data of a Person Profile.

### Method
GET

### Endpoint
/person-profile

### Response
#### Success Response (200)
- **connections** (integer) - Number of connections
- **people_also_viewed** (array) - List of related profiles
- **activities** (array) - List of recent activities
- **meta** (object) - Metadata including last_updated timestamp
```

--------------------------------

### GET /job-search

Source: https://enrichlayer.com/docs/api/v2/jobs-api/job-profile

Retrieve a list of jobs posted by a specific company.

```APIDOC
## GET /job-search

### Description
List jobs posted by a company.

### Method
GET

### Endpoint
/job-search
```

--------------------------------

### API Response Structure

Source: https://enrichlayer.com/docs/api/v2/search-api/person-search

Example of the JSON response object returned by the API containing profile details and work experience.

```json
{
  "results": [
    {
      "linkedin_profile_url": "https://www.linkedin.com/in/satyanadella",
      "profile": {
        "public_identifier": "satyanadella",
        "profile_pic_url": "https://assets.enrichlayer.com/pp/profilepic/7d369850c9fe8c35e78a6a50c75334f5",
        "background_cover_image_url": "https://assets.enrichlayer.com/pp/profilepic/fe878f911fecd238e169a23b12103b0e",
        "first_name": "Satya",
        "last_name": "Nadella",
        "full_name": "Satya Nadella",
        "follower_count": 11888127,
        "occupation": "Chairman and CEO at Microsoft",
        "headline": "Chairman and CEO at Microsoft",
        "summary": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
        "country": "US",
        "country_full_name": "United States of America",
        "city": "Redmond",
        "state": "Washington",
        "experiences": [
          {
            "starts_at": {
              "day": 1,
              "month": 2,
              "year": 2014
            },
            "ends_at": null,
            "company": "Microsoft",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/microsoft",
            "company_facebook_profile_url": null,
            "title": "Chairman and CEO",
            "description": null,
            "location": "Greater Seattle Area",
            "logo_url": "https://assets.enrichlayer.com/ll/D560BAQH32RJQCl3dDQ/company-logo_100_100/B56ZYQ0mrGGoAU-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=rr_7_bFRKp6umQxIHErPOZHtR8dMPIYeTjlKFdotJBY"
          },
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 2018
            },
            "ends_at": null,
            "company": "University of Chicago",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/uchicago",
            "company_facebook_profile_url": null,
            "title": "Member Board Of Trustees",
            "description": null,
            "location": null,
            "logo_url": "https://assets.enrichlayer.com/pp/profilepic/f40c5f31ef246aeb1000ffb4e40f2991"
          },
          {
            "starts_at": {
              "day": 1,
              "month": 1,
              "year": 2017
            },
            "ends_at": {
              "day": 31,
              "month": 12,
              "year": 2024
            },
            "company": "Starbucks",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/starbucks",
            "company_facebook_profile_url": null,
            "title": "Board Member",
            "description": null,
            "location": null,
            "logo_url": "https://assets.enrichlayer.com/ll/C4D0BAQEQxk9y2rk7Hw/company-logo_100_100/company-logo_100_100/0/1631316692276?e=2147483647&v=beta&t=itdoVXP3gnqtQ7Grar4B3YoPyw-Ors9bKMZlZpb0QcY"
          }
        ]
```

--------------------------------

### Company Profile Endpoint

Source: https://enrichlayer.com/docs/api/v2/company-api/employee-count

Get structured data of a Company Profile.

```APIDOC
## GET /api/v2/company/profile

### Description
Get structured data of a Company Profile.

### Method
GET

### Endpoint
`/api/v2/company/profile`

### Parameters
#### Query Parameters
- **url** (string) - Required - The URL of the company profile.

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **[Fields will be documented here based on actual response structure]**

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### GET /api/v2/company/resolve-id

Source: https://enrichlayer.com/docs/api/v2/company-api/company-id-lookup

Look up the vanity ID of a company by its numeric ID.

```APIDOC
## GET /api/v2/company/resolve-id

### Description
Look up the vanity ID of a company by its numeric ID.

### Method
GET

### Endpoint
https://enrichlayer.com/api/v2/company/resolve-id

### Parameters
#### Query Parameters
- **id** (string) - Required - The company's internal, immutable numeric ID.

### Request Example
curl -X GET "https://enrichlayer.com/api/v2/company/resolve-id?id=1441"

### Response
#### Success Response (200)
- **vanity_id** (string) - The vanity ID of the company.

#### Response Example
{
  "vanity_id": "google"
}
```
Tokens:
Raw