Skills API

Click here for an interactive tutorial of how to use IYS API

Access Token

Before you start using It's Your Skills API, you need to authenticate your usage by acquiring an access token for your Client ID and Client Secret.

In order to get an access token, you have to make HTTP request, as below using any of your preferred HTTP clients (Postman, Curl, Ajax..)

Please make sure that you add the parameters as form parameters and not as JSON data or any other parameters.

Below is an example of this request, done in PHP.

                    $response = $guzzle->post('https://skills.itsyourskills.com/oauth/token', [
                      'form_params' => [
                        'grant_type' => 'client_credentials',
                        'client_id' => 'client-id', //insert your client id here
                        'client_secret' => 'client-secret', //insert your client secret here
                      ],
                    ]);
                  

If everything goes right, you should receive a response similar to that shown below

                    
                      {
                        "token_type": "Bearer",
                        "expires_in": 31536000,
                        "access_token": "Your access token received from our servers" //keep this for future API calls
                      }
                    
                  

All you need is the value of access_token from the above code

Using the method mentioned above, you can generate a new access_token every time. Your old access token will be invalidated

API Calls

Skill/Role Search

You can search for any skill or a job role you want from an extensive database of more than 70,000 skills. This call returns a all the matching skills and job roles for the search term you used.

In order to make any API call to the It's Your Skills API, you pass the access_token in the Authorization header of each API call, as shown below

                  Authorization: Bearer 'Your access token goes here'
                

You then send your search query as a parameter to the API route using GET method, as shown below.

                  https://skills.itsyourskills.com/api/skill-search?q=php developer
                

Here, php developer is your search query and it returns the JSON shown below

                  
                    {
  "skills": [
    {
      "id": "a4yZKlbVLaAlDQ59",
      "skill_name": "PHP Web Developer",
      "r": "12.689921379089355",
      "is_role": "1",
      "skill_type": "0"
    },
    {
      "id": "Xp4g5E1ZYBvdbKN3",
      "skill_name": "Developer",
      "r": "5.7024245262146",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "rG0O2Ezez7o6yQYL",
      "skill_name": "Puppet Developer",
      "r": "5.6383209228515625",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "aOY1AEPAzbqde3zn",
      "skill_name": "Java Developer",
      "r": "5.6383209228515625",
      "is_role": "1",
      "skill_type": "0"
    },
    {
      "id": "N5JO8EXoZY36Aovb",
      "skill_name": "Middleware Developer",
      "r": "5.6383209228515625",
      "is_role": "1",
      "skill_type": "0"
    },
    {
      "id": "rG0O2Ezez2j6yQYL",
      "skill_name": ".Net Developer",
      "r": "5.6383209228515625",
      "is_role": "1",
      "skill_type": "0"
    },
    {
      "id": "z9w7WdDr4L26JGYy",
      "skill_name": "Frontend Developer",
      "r": "5.6383209228515625",
      "is_role": "1",
      "skill_type": "0"
    },
    {
      "id": "O2QyVl8ZAK2EGX4N",
      "skill_name": "WebSphere Integration Developer",
      "r": "5.575642108917236",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "O2QyVl8ZRK7EGX4N",
      "skill_name": "Oracle Developer Suite",
      "r": "5.575642108917236",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "kxzqO64ZYMZd4BmJ",
      "skill_name": "CIW Web Developer",
      "r": "5.575642108917236",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "NzoyjlaXwrndn1rg",
      "skill_name": "Adobe Analytics Developer",
      "r": "5.575642108917236",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "ge9ZWdJ7PDelJmb7",
      "skill_name": "JavaBeans Developer Certification",
      "r": "5.575642108917236",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "O2QyVl8ZrneEGX4N",
      "skill_name": "Hyperion Developer Certification",
      "r": "5.575642108917236",
      "is_role": "0",
      "skill_type": "0"
    },
    {
      "id": "aqVz56nzADq6BKGo",
      "skill_name": "Web Application Developer",
      "r": "5.575642108917236",
      "is_role": "1",
      "skill_type": "0"
    },
    .
    .
    .
    .
    .
    .
    .
    .
    .
    {
      "id": "O2QyVl8Z5VrEGX4N"
      "skill_name": "JavaOS",
      "r": 0,
      "is_role": 0,
      "skill_type": "0"
    }]
  }
                  
                

The above JSON response gives you all the skills that have the word 'php' or 'developer' in them. r is the ranking of the skill based on the similarity to your search query.

Also, the is_role property indicates if the returned result is an individual skill or a Job Role.

Inorder to limit the number of search results you get, you can pass in the limit l and offset o parameters.

The limit parameter determines the number of results you need in your request. So the following request will fetch you the first 10 results of your search.

                  https://skills.itsyourskills.com/api/skill-search?q=java&l=10
                

The above code fetches you results from 1 to 10. Now, if you need results from 11 to 30, you add the offset parameter along with the limit parameter as follows

                  https://skills.itsyourskills.com/api/skill-search?q=java&l=20&o=10
                

The skill_type property in the returned json object indicates if the skill is a functional (0) or behavioral (1) skill.

You can also search skills based on the skill type. If you need only functional skills, send the search query with the parameter skill_type=0. If you need only behavioral skills, send the search query with the parameter skill_type=1

In the absence of skill_type parameter, the search result returns all the skills from both functional and behavioral category

                  https://skills.itsyourskills.com/api/skill-search?q=java&l=20&o=10&skill_type=0
                

Related Skill Search & Role Search

Once you have picked your skill/role from the above search, you can use its ID to fetch more skills related to that skill.

In order to make any API call to the It's Your Skills API, you pass the access_token in the Authorization header of each API calls as shown below.

                  Authorization: Bearer 'Your access token goes here'
                

To get all the related skills, you pass the ID of the skill from the previous response in a GET method, as shown below.

                  https://skills.itsyourskills.com/api/related-skill-search?id=bx0VrlRm7pndaOwv
                

Here z9w7WdDr0M76JGYy is the ID of SAP NetWeaver Developer Studio and it returns the JSON shown below

                  
                    {
  "skill_name": "SAP NetWeaver Developer Studio",
  "skill_category": "Compilers and IDE",
  "is_role": false,
  "related_skills": [
    {
      "id": "aPgVmleqyW5ly904",
      "skill_name": "Adobe Flash Builder"
    },
    {
      "id": "KbmMBEwWmqgEL10y",
      "skill_name": "Google Android Studio"
    },
    {
      "id": "ko84zlVeGWPdDybQ",
      "skill_name": "Google Android IDE"
    },
    {
      "id": "ynkeVd7Q0qR6Y305",
      "skill_name": "IBM Rational Rhapsody"
    },
    {
      "id": "NkQRalyjVqm6pYMx",
      "skill_name": "IBM RAD"
    },
    {
      "id": "ge9ZWdJ75VplJmb7",
      "skill_name": "IBM VisualAge"
    },
    {
      "id": "gNnywEWRLVG6a18V",
      "skill_name": "Jbuilder"
    },
    {
      "id": "bx0VrlRmGJrdaOwv",
      "skill_name": "IntelliJ Idea"
    },
    {
      "id": "pyxG3dgnBWAEg4eK",
      "skill_name": "Genuitec MyEclipse"
    },
    .
    .
    .
    .
    .
    .
    .
    .
    {
      "id": "NzoyjlaX5vndn1rg",
      "skill_name": "Prolog"
    },
    {
      "id": "a4yZKlbV7R9lDQ59",
      "skill_name": "Pro*C/C++"
    },
    {
      "id": "7yGaREZe7v96Q8NW",
      "skill_name": "Xtend"
    },
    {
      "id": "bx0VrlRm7pndaOwv",
      "skill_name": "Java"
    }
    ],
    "related_categories": [
    {
      "id": "q3znolpexzq6xGBY",
      "skill_name": "Business Domain"
    },
    {
      "id": "rG0O2Eze1LV6yQYL",
      "skill_name": "Concepts, Software Development"
    },
    {
      "id": "pyxG3dgnNA8Eg4eK",
      "skill_name": "Operational Role"
    },
    {
      "id": "NzoyjlaXGV8dn1rg",
      "skill_name": "Programming Languages"
    },
    {
      "id": "rL41Q6xW2OWlJbAn",
      "skill_name": "Software Domain"
    },
    {
       "id": "oLeR0EQ4Gmw6qpgX",
       "skill_name": "Tools and Technologies"
    }]
  }
  

In the above JSON response, skill_name is the name of the skill you searched for.

skill_category is the category to which the skill belongs

related_skills gives all the skills that belong in this category

related_categories has all the categories related to the category of the searched skill.

Incase you passed the id of a skill which has the is_role property as 1, the you get another set of skills which are assigned to that particular Role. From where, you can pick a skill and pass it to the same API call to get the related skills. Following is a result when you pass the id of Php Web Developer

                                    
                                        {
  "role_name": "PHP Web Developer",
  "is_role": true,
  "rfs": [
    {
      "id": "aOY1AEPA5Made3zn",
      "skill_name": "Programming"
    },
    {
      "id": "2mBOR6BV74361Q8A",
      "skill_name": "Database Development"
    },
    {
      "id": "aqVz56nzZa76BKGo",
      "skill_name": "Certifications"
    },
    {
      "id": "q3znolpexzq6xGBY",
      "skill_name": "Business Domain"
    },
    {
      "id": "1PXYnEKy0qWlJqpV",
      "skill_name": "Programming Concepts"
    },
    {
      "id": "Pq35KdkrJ2zERAOZ",
      "skill_name": "Software Development Methodologies"
    },
    {
      "id": "o0VepdmNpnrlOq1M",
      "skill_name": "Web Application Development"
    },
    {
      "id": "KX1wmlo3ZKolYVeZ",
      "skill_name": "Configuration, Release, Version Control"
    },
    {
      "id": "N5JO8EXo84K6Aovb",
      "skill_name": "RDBMS"
    },
    {
      "id": "q3znolpeQVa6xGBY",
      "skill_name": "Bug Tracking"
    },
    {
      "id": "KX1wmlo3BvRlYVeZ",
      "skill_name": "Compilers and IDE"
    },
    {
      "id": "NzoyjlaXGeGdn1rg",
      "skill_name": "MVC"
    },
    {
      "id": "7yGaREZeGzr6Q8NW",
      "skill_name": "Frontend Development/Scripting"
    },
    {
      "id": "NzoyjlaX5Zrdn1rg",
      "skill_name": "Middleware"
    },
    {
      "id": "rG0O2EzekNo6yQYL",
      "skill_name": "Web Services"
    },
    {
      "id": "pyxG3dgnNA8Eg4eK",
      "skill_name": "Operational Role"
    },
    {
      "id": "NzoyjlaXGV8dn1rg",
      "skill_name": "Programming Languages"
    }
  ],
  "rbs": []
}
                                    
                                

In the above response, the is_role property is true because the results are all skills that are assigned to the role 'PHP Web Developer'. The rfs property has the list of all functional skills and rbs property has the list of all behavioral skills assigned the role

Related Category Search

Apart from searching based on the skill, you can also choose a category and fetch all the skills under that category.

In order to make any API call to the It's Your Skills API, you pass the access_token in the Authorization header of each API call as shown below.

                Authorization: Bearer 'Your access token goes here'
              

To do that, pass the ID of any related_category from the above JSON response in a GET method as shown below.

                https://skills.itsyourskills.com/api/category-search?id=q3znolpexzq6xGBY
              

Here q3znolpexzq6xGBY is the ID of Business Domain category and it returns the JSON shown below.

                
                  {
                    "category_name": "Business Domain",
                    "skills": [
                    {
                      "id": "19KMQENJ2eYELDjP",
                      "skill_name": "Utilities"
                    },
                    {
                      "id": "8rxyB6qjPbgE9pLk",
                      "skill_name": "Life Sciences"
                    },
                    {
                      "id": "ko84zlVerakdDybQ",
                      "skill_name": "Information Research, Processing"
                    },
                    {
                      "id": "z7jAgdvoKpxlVwrO",
                      "skill_name": "HR"
                    },
                    {
                      "id": "pyxG3dgnyO8Eg4eK",
                      "skill_name": "Healthcare"
                    },
                    {
                      "id": "wZqzBdLRbGD601bY",
                      "skill_name": "Government Services"
                    },
                    .
                    .
                    .
                    .
                    .
                    .
                    .
                    {
                      "id": "ynkeVd7Qp2Z6Y305",
                      "skill_name": "Other Financial Services"
                    },
                    {
                      "id": "oeA2V63XpeMEJnMG",
                      "skill_name": "Marketing"
                    },
                    {
                      "id": "yPxgV6GArkZdR8NJ",
                      "skill_name": "Banking, Investment Banking"
                    }
                    ],
                    "related_categories": [
                    {
                      "id": "q3znolpexzq6xGBY",
                      "skill_name": "Business Domain"
                    },
                    {
                      "id": "rG0O2Eze1LV6yQYL",
                      "skill_name": "Concepts, Software Development"
                    },
                    {
                      "id": "pyxG3dgnNA8Eg4eK",
                      "skill_name": "Operational Role"
                    },
                    {
                      "id": "NzoyjlaXGV8dn1rg",
                      "skill_name": "Programming Languages"
                    },
                    {
                      "id": "rL41Q6xW2OWlJbAn",
                      "skill_name": "Software Domain"
                    },
                    {
                      "id": "oLeR0EQ4Gmw6qpgX",
                      "skill_name": "Tools and Technologies"
                    }]
                  }
                
              

In the above JSON response, category_name is the name of the category you searched for.

skills are all the skills under that category.

related_categories has all the categories related to the category searched.