NAV
shell

Introduction

Welcome to Wandify’s API!

Seamlessly integrate with our platform to empower your applications and uncover valuable insights. Whether you’re enhancing contact information, exploring organizational details, or optimizing sales and recruitment processes, our API provides a flexible and comprehensive solution tailored to meet your diverse needs.

Authentication

Wandify uses API keys to allow access to the API. You may request an API key here.

Wandify expects the API key to be included in all API requests to the server as a query string parameter.

Example request

curl --location 'https://api.wandify.io/api/v1/health?apiKey=YOUR_API_KEY' \
--header 'content-type: text/plain'

Example request

GET https://api.wandify.io/api/v1/health

Rate limits

Requests to our API will be limited by different type of credits in accordance with your current pricing plan.

Rate limits

For each endpoint, the limit is 5 requests per second.

Account information retrieval

Example request

curl --location 'https://api.wandify.io/api/v1/accountInfo?apiKey=YOUR_API_KEY' \
--header 'content-type: text/plain'

Example response

{
  "firstName": "Rosetta",
  "lastName": "Wiza",
  "accountStatus": "active",
  "paidTill": 1748610716429,
  "contactsCredits": 46641,
  "exportCredits": 358577,
  "role": "ROLE_ADMIN",
  "notLocked": true,
  "notRemoved": true
}

This endpoint retrieves detailed account information based on the provided API key. It returns the user’s personal details, account status, subscription information, and available contact and export credits.

HTTP Request

GET https://api.wandify.io/api/v1/accountInfo

Query parameters

Parameter Description
apiKey Your generated API key

Contact enrichment

Example request

curl --location -X POST 'https://api.wandify.io/api/v1/searchContacts' \
-H 'content-type: application/json' \
-d '{ "apiKey": "a808bfa3c8eb4sd4a2s2809d2d20d868", "linkedinUrl": "https://linkedin.com/in/username", "firstName": "Rosetta", "lastName": "Wiza", "companyName": "Wandify Inc.", "companyDomain": "wandify.io", "email": "example@domain.com" }'

Example response

[
  {
    "type":"EMAIL",
    "value":"example@domain.com"
  },
  {
    "type":"PHONE",
    "value":"1234567890"
  }
]

This endpoint enriches a profile’s contact information using various parameters provided, such as LinkedIn URL, first name, last name, company name, company domain, and email. The input only accepts LinkedIn regular URLs, not Sales Navigator or Talent / Recruiter LinkedIn products. It will deduct 1 contact credit for each non-empty record returned.

HTTP Request

POST https://api.wandify.io/api/v1/searchContacts

JSON Body Parameters

Parameter Description Example
apiKey Your generated API key a808bfa3c8eb4sd4a2s2809d2d20d868
linkedinUrl (optional) Profile URL from LinkedIn https://linkedin.com/in/username
firstName (optional) The person's first name Rosetta
lastName (optional) The person's last name Wiza
companyName (optional) The person's company name Wandify Inc.
companyDomain (optional) The person's company domain wandify.io
email (optional) The person's email example@domain.com

Profile enrichment

Example request

curl --location -X POST 'https://api.wandify.io/api/v1/searchProfile' \
-H 'content-type: application/json' \
-d '{ "apiKey": "a808bfa3c8eb4sd4a2s2809d2d20d868", "linkedinUrl": "https://linkedin.com/in/username", "firstName": "Rosetta", "lastName": "Wiza", "companyName": "Wandify Inc.", "companyDomain": "wandify.io", "email": "example@domain.com" }'

Example response

{
    "locationName": "Redmond, Washington, United States",
    "firstName": "Rosetta",
    "lastName": "Wiza",
    "headline": "Senior Software Engineer",
    "url": "https://linkedin.com/in/username",
    "publicIdentifier": "example_person",
    "summary": "An experienced professional with over 15 years in Software Engineering",
    "picture": "https://media.licdn.com/dms/image/C5603AQHHUuOSlRVA1w/profile-displayphoto-shrink_200_200/0/1579726625398?e=1710979200&v=beta&t=BEvT1JTj3Af7dMrjaAdEkAxJETNCoLwQM-vG9nIQuGk",
    "openToWork": false,
    "positions": [
        {
            "startYear": 2014,
            "startMonth": 2,
            "durationMonth": 0,
            "durationYear": 10,
            "companyName": "Amazon",
            "title": "Chairman and CEO",
            "locationName": "Greater Seattle Area"
        }
    ],
    "educations": [
        {
            "degreeName": "Bachelor's Degree",
            "fieldOfStudy": "Electrical Engineering",
            "schoolName": "Manipal Institute of Technology, Manipal"
        }
    ],
     "certifications": [
        {
            "startYear": 2020,
            "startMonth": 10,
            "endYear": 2023,
            "endMonth": 10,
            "durationMonth": 1,
            "durationYear": 3,
            "name": "AWS Certified Solutions Architect – Associate",
            "authority": "Amazon Web Services (AWS)"
        }
    ],
    "skills": [
        {
            "skillName": "Software Engineering"
        },
        {
            "skillName": "Java"
        }
    ],
    "languages": [
        {
            "name": "English",
            "level": "FULL_PROFESSIONAL"
        }
    ]
}

This endpoint enables you to access a range of profile information, including job history, educational background, skills, and other details using various parameters provided, such as LinkedIn URL, first name, last name, company name, company domain, and email. The input only accepts LinkedIn regular URLs, not Sales Navigator or Talent / Recruiter LinkedIn products. It will deduct 1 export credit for each non-empty record returned.

HTTP Request

POST https://api.wandify.io/api/v1/searchProfile

JSON Body Parameters

Parameter Description Example
apiKey Your generated API key a808bfa3c8eb4sd4a2s2809d2d20d868
linkedinUrl (optional) Profile URL from LinkedIn https://linkedin.com/in/username
firstName (optional) The person's first name Rosetta
lastName (optional) The person's last name Wiza
companyName (optional) The person's company name Wandify Inc.
companyDomain (optional) The person's company domain wandify.io
email (optional) The person's email example@domain.com
shell