API docs by Redocly

Mawsool LinkedIn Enrichment (1.0.0)

Download OpenAPI specification:Download

This API enriches LinkedIn profiles with comprehensive contact and company data.

It operates on a waterfall model:

  1. A request is made to the primary data provider (Apollo).
  2. If the initial data is insufficient for the user's request, a background search is initiated with a secondary provider (SignalHire).

This can result in two types of responses:

  • Synchronous (200 OK): Data is found immediately and returned.
  • Asynchronous (202 Accepted): A background search has started. The user should retry the same request after a short delay to get the final result.

Enrichment

Enrich a LinkedIn Profile with Comprehensive Data

Retrieves comprehensive contact and company information for a given LinkedIn profile URL.

Workflow: This endpoint uses a waterfall enrichment process. If data is not immediately available, it will trigger a background search.

  • If you receive a 200 OK response, the data is complete.
  • If you receive a 202 Accepted response, it means a background search has begun. You should retry the exact same request in 30-60 seconds to retrieve the final result.

Credits:

  • A charge of 5 credits is applied for retrieving a valid email.
  • A charge of 20 credits is applied for retrieving a valid phone number.
  • Charges are only applied once per data type for each unique profile.
Authorizations:
ApiKeyAuth
query Parameters
url
required
string <uri>
Example: url=https://www.linkedin.com/in/omar-mahmoud120/

The full LinkedIn profile URL to enrich.

fields
string
Example: fields=email,phone

Comma-separated list of fields to retrieve (e.g., email, phone). If omitted, the API will search for all available data.

Responses

Response samples

Content type
application/json
{
  • "contact__first_name": "Omar",
  • "contact__last_name": "Mahmoud",
  • "contact__name": "Omar Mahmoud",
  • "contact__title": "Chief Technology Officer",
  • "contact__organization_name": "SP-Apps",
  • "contact__email": "omar.mahmoud120@gmail.com",
  • "contact__email_status": "deliverable",
  • "seniority": "director",
  • "departments": [
    ],
  • "subdepartments": [
    ],
  • "functions": [
    ],
  • "contact__headline": "Co-founder & CTO | Mobile/Web Solutions Architect...",
  • "contact__phone_numbers": [
    ],
  • "organization__estimated_num_employees": "1-10",
  • "organization__industries": [
    ],
  • "organization__keywords": [
    ],
  • "contact__linkedin_url": "https://www.linkedin.com/in/omar-mahmoud120",
  • "organization__website_url": "http://www.sp-apps.com",
  • "organization__linkedin_url": "https://www.linkedin.com/company/sp-apps",
  • "organization__facebook_url": "http://example.com",
  • "organization__twitter_url": "http://example.com",
  • "contact__city": "Amman",
  • "contact__state": "Jordan",
  • "contact__country": "Jordan",
  • "organization__raw_address": "string",
  • "organization__city": "Amman, Jordan",
  • "organization__state": "string",
  • "organization__country": "string",
  • "organization__short_description": "string",
  • "organization__current_technologies": [
    ],
  • "organization__founded_year": 0,
  • "organization__annual_revenue": "string",
  • "organization__total_funding": "string",
  • "organization__latest_funding_stage": "string",
  • "organization__funding_events": [
    ],
  • "organization__latest_funding_round_date": "2019-08-24",
  • "organization__logo_url": "http://example.com",
  • "contact__photo_url": "http://example.com",
  • "contact__all_emails": [
    ],
  • "employmentHistory": [
    ],
  • "retrievedAt": "2019-08-24T14:15:22Z",
  • "status": "success",
  • "message": "Requested email and phone information retrieved.",
  • "creditsRemaining": 9730,
  • "linkedin_url_searched": "http://example.com"
}

Enrich a LinkedIn Profile (Legacy)

This endpoint functions identically to /contact. It is maintained for backward compatibility. Please prefer using the /contact endpoint for new integrations.

Authorizations:
ApiKeyAuth
query Parameters
url
required
string <uri>
Example: url=https://www.linkedin.com/in/omar-mahmoud120/

The full LinkedIn profile URL to enrich.

fields
string
Example: fields=email,phone

Comma-separated list of fields to retrieve (e.g., email, phone). If omitted, the API will search for all available data.

Responses

Response samples

Content type
application/json
{
  • "contact__first_name": "Omar",
  • "contact__last_name": "Mahmoud",
  • "contact__name": "Omar Mahmoud",
  • "contact__title": "Chief Technology Officer",
  • "contact__organization_name": "SP-Apps",
  • "contact__email": "omar.mahmoud120@gmail.com",
  • "contact__email_status": "deliverable",
  • "seniority": "director",
  • "departments": [
    ],
  • "subdepartments": [
    ],
  • "functions": [
    ],
  • "contact__headline": "Co-founder & CTO | Mobile/Web Solutions Architect...",
  • "contact__phone_numbers": [
    ],
  • "organization__estimated_num_employees": "1-10",
  • "organization__industries": [
    ],
  • "organization__keywords": [
    ],
  • "contact__linkedin_url": "https://www.linkedin.com/in/omar-mahmoud120",
  • "organization__website_url": "http://www.sp-apps.com",
  • "organization__linkedin_url": "https://www.linkedin.com/company/sp-apps",
  • "organization__facebook_url": "http://example.com",
  • "organization__twitter_url": "http://example.com",
  • "contact__city": "Amman",
  • "contact__state": "Jordan",
  • "contact__country": "Jordan",
  • "organization__raw_address": "string",
  • "organization__city": "Amman, Jordan",
  • "organization__state": "string",
  • "organization__country": "string",
  • "organization__short_description": "string",
  • "organization__current_technologies": [
    ],
  • "organization__founded_year": 0,
  • "organization__annual_revenue": "string",
  • "organization__total_funding": "string",
  • "organization__latest_funding_stage": "string",
  • "organization__funding_events": [
    ],
  • "organization__latest_funding_round_date": "2019-08-24",
  • "organization__logo_url": "http://example.com",
  • "contact__photo_url": "http://example.com",
  • "contact__all_emails": [
    ],
  • "employmentHistory": [
    ],
  • "retrievedAt": "2019-08-24T14:15:22Z",
  • "status": "success",
  • "message": "Requested email and phone information retrieved.",
  • "creditsRemaining": 9730,
  • "linkedin_url_searched": "http://example.com"
}

Enrich a LinkedIn Profile (Alternative Provider)

Retrieves profile data from a specific alternative provider (API Club). The response format from this endpoint may differ from the standard /contact response.

Authorizations:
ApiKeyAuth
query Parameters
url
required
string <uri>
Example: url=https://www.linkedin.com/in/ingmar-klein

The full LinkedIn profile URL to enrich.

Responses

Response samples

Content type
application/json
{ }