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 Search

You can search for any skill you want from an extensive database of more than 70,000 skills. This call returns all the matching skills 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, java is your search query and it returns the JSON shown below

                  
  {
  "skills": [
    {
      "id": "Pq35Kdk3YpZdRAOZ",
      "skill_name": "JavaOS",
      "ancestor_names": "Embedded Operating Systems<=Systems Level Software Development Related Skills Categories"
    },
    {
      "id": "N5JO8EXmp8dAovbq",
      "skill_name": "JavaFX",
      "ancestor_names": "J2EE Framework<=Software Development Related Skills Categories"
    },
    {
      "id": "aOY1AEPKPL6e3znN",
      "skill_name": "Java",
      "ancestor_names": "Programming Languages<=Software Development Related Skills Categories"
    },
    {
      "id": "a4yZKlbXgMzEDQ59",
      "skill_name": "JavaScript Programmer",
      "ancestor_names": "Roles - Programmer Related<=Software Development Related Skills Categories"
    },
    {
      "id": "aPgVmleZaz6y9048",
      "skill_name": "JSP (JavaServer Pages)",
      "ancestor_names": "J2EE Framework<=Software Development Related Skills Categories"
    },
    {
      "id": "Q7zbMd9OaJ6308LD",
      "skill_name": "JSF (JavaServer Faces)",
      "ancestor_names": "J2EE Framework<=Software Development Related Skills Categories"
    },
    {
      "id": "yPxgV6GBVklR8NJB",
      "skill_name": "JavaScriptMVC, MVC Framework",
      "ancestor_names": "MVC<=Software Development Related Skills Categories"
    },
    {
      "id": "g5KN9drv07d4a3p8",
      "skill_name": "Java Servlets",
      "ancestor_names": "J2EE Framework<=Software Development Related Skills Categories"
    },
    {
      "id": "q3znolpLJLlxGBY2",
      "skill_name": "Java Technologies",
      "ancestor_names": "Software Development Related Skills Categories"
    },
    {
      "id": "1PXYnEKAR5lJqpVZ",
      "skill_name": "JavaScript Object Notation",
      "ancestor_names": "J2EE Framework<=Software Development Related Skills Categories"
    },
                      .
                      .
                      .
                      .
                      .
                      .
                      .
                      .
                      .
    {
      "id": "ynkeVd7PaPlY305o",
      "skill_name": "JavaBeans Developer Certification",
      "ancestor_names": "Oracle Certification<=IT Certifications"
    },
    {
      "id": "a4yZKlbXgvzEDQ59",
      "skill_name": "Javascript (JS) Programmer",
      "ancestor_names": "Roles - Programmer Related<=Software Development Related Skills Categories"
    }]
  }

If you searched for a valid skill, you get the following result. Each skill has a unique id , a skill_name (name of the actual skill) and ancestor_names (trail of skill categories that lead up to the skill, separated by the delimiter '<=' with the direct parent on the left and the furthest ancestor on the right).

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

Related Skill Search

Once you have picked your skill 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=aOY1AEPKPL6e3znN

Here aOY1AEPKPL6e3znN is the ID of Java and it returns the JSON shown below

                  
                    {
  "id": "aOY1AEPKPL6e3znN",
  "skill_name": "Java",
  "category_name": "Programming Languages",
  "category_id": "aqVz56nPY5dBKGo4",
  "is_category": 0,
  "related_skills": [
    {
      "id": "VewG3d5oM7e6J7km",
      "skill_name": "Xtend",
      "plus": 1,
      "parent_id": "aqVz56nPY5dBKGo4",
      "ancestor_names": "Programming Languages",
      "a_ids": ",aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
    {
      "id": "5negGlOX156XkWRV",
      "skill_name": "XPath",
      "plus": 1,
      "parent_id": "aqVz56nPY5dBKGo4",
      "ancestor_names": "Programming Languages",
      "a_ids": ",aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
    {
      "id": "8rxyB6qrvnE9pLk2",
      "skill_name": "XML",
      "plus": 1,
      "parent_id": "aqVz56nPY5dBKGo4",
      "ancestor_names": "Programming Languages",
      "a_ids": ",aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
    {
      "id": "KbmMBEwDLmdL10yA",
      "skill_name": "Visual C++",
      "plus": 0,
      "parent_id": "aqVz56nPY5dBKGo4",
      "ancestor_names": "Programming Languages",
      "a_ids": ",aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
                      .
                      .
                      .
                      .
                      .
                      .
    {
      "id": "Q7zbMd9Bq9l308LD",
      "skill_name": "ActionScript",
      "plus": 1,
      "parent_id": "aqVz56nPY5dBKGo4",
      "ancestor_names": "Programming Languages",
      "a_ids": ",aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
    {
      "id": "aOY1AEPKPL6e3znN",
      "skill_name": "Java",
      "plus": 1,
      "parent_id": "aqVz56nPY5dBKGo4",
      "ancestor_names": "Programming Languages",
      "a_ids": ",aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    }
  ],
  "related_categories": [
    {
      "id": "pyxG3dgbz8Eg4eKV",
      "skill_name": "Bug Tracking Tools",
      "child_ids": []
    },
    {
      "id": "kxzqO64D2364BmJD",
      "skill_name": "Code Analysis Tools / Software",
      "child_ids": []
    },
                      .
                      .
                      .
                      .
                      .
                      .
    {
      "id": "ge9ZWdJR29pdJmb7",
      "skill_name": "Software Domain",
      "child_ids": []
    }
  ]
}

You will get a Json response with the skill_name of the id you passed, id is the id you passed, category_name is the parent of the skill, category_id is the id of the parent of chosen skill, is_category is 1 if the chosen skill itself is a category with more skills under it.

related_skills has all the sibling skills of the chosen skill. id is the id of the corresponding related skill, skill_name is the name of the skills, plus is 1 if the related skill has sub-skills; to get the sub-skills, id of the related skill with plus attribute as 1 is passed to Step 4. parent_id is the id of the direct parent of the related skill, ancestor_names is the trail of skill categories that lead up to the related skill, separated by the delimiter '<=' with the direct parent on the left and the furthest ancestor on the right, a_ids is the trail of ids of skill categories that lead up to the skill, separated by the delimiter ',' with the direct parent on the left and the furthest id on the right equals 0 which means root.

related_categories array has all the skill categories that are related to the searched skill. id is the id of the related category, skill_name is the name of the related category. If a skill is associated as relation with the searched skill, those skills' categories are given in related_categories and the associated skills' ids are given in child_ids

To get all the skills under a skill category, pass the id of the category in Step 4


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=VewG3d5oM7e6J7km

Here VewG3d5oM7e6J7km is the ID of Xtend which is a related skill but has the attribute plus as 1 so this itself is a category. You can pass id of a related category or a related skill with plus attribute as 1 to get all the sub skills and children skills respectively.

                
                  {
  "skill_name": "Xtend",
  "id": "VewG3d5oM7e6J7km",
  "category_name": "Programming Languages",
  "category_id": "aqVz56nPY5dBKGo4",
  "is_category": 1,
  "related_skills": [
    {
      "id": "z9w7WdDV1a6JGYyO",
      "skill_name": "Xtend Library API",
      "plus": 0,
      "parent_id": "VewG3d5oM7e6J7km",
      "ancestor_names": "Xtend<=Programming Languages",
      "a_ids": ",VewG3d5oM7e6J7km,aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
    {
      "id": "a4yZKlb100dDQ59q",
      "skill_name": "Xtend Extension Methods",
      "plus": 0,
      "parent_id": "VewG3d5oM7e6J7km",
      "ancestor_names": "Xtend<=Programming Languages",
      "a_ids": ",VewG3d5oM7e6J7km,aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
    {
      "id": "KX1wmlonm0dYVeZq",
      "skill_name": "Xtend Expressions",
      "plus": 0,
      "parent_id": "VewG3d5oM7e6J7km",
      "ancestor_names": "Xtend<=Programming Languages",
      "a_ids": ",VewG3d5oM7e6J7km,aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
                    .
                    .
                    .
                    .
                    .
                    .
    {
      "id": "aOY1AEPKXP6e3znN",
      "skill_name": "Class Path Setup and Testing",
      "plus": 0,
      "parent_id": "VewG3d5oM7e6J7km",
      "ancestor_names": "Xtend<=Programming Languages",
      "a_ids": ",VewG3d5oM7e6J7km,aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    },
    {
      "id": "rL41Q6xkeAlJbAnj",
      "skill_name": "Active Annotations",
      "plus": 0,
      "parent_id": "VewG3d5oM7e6J7km",
      "ancestor_names": "Xtend<=Programming Languages",
      "a_ids": ",VewG3d5oM7e6J7km,aqVz56nPY5dBKGo4,ONzoyjlar6n1rgpM,"
    }
  ],
  "related_categories": [
    {
      "id": "pyxG3dgbz8Eg4eKV",
      "skill_name": "Bug Tracking Tools",
      "child_ids": []
    },
    {
      "id": "kxzqO64D2364BmJD",
      "skill_name": "Code Analysis Tools / Software",
      "child_ids": []
    },
    {
      "id": "rG0O2EzrjyEyQYLp",
      "skill_name": "Compilers and IDE",
      "child_ids": []
    },
                    .
                    .
                    .
                    .
                    .

    {
      "id": "ge9ZWdJR29pdJmb7",
      "skill_name": "Software Domain",
      "child_ids": []
    }
  ]
}

You will get a Json response with the skill_name of the id you passed, id is the id you passed, category_name is the parent of the skill, category_id is the id of the parent of chosen skill, is_category is 1 if the chosen skill itself is a category with more skills under it.

related_skills has all the sibling skills of the chosen skill. id is the id of the corresponding related skill, skill_name is the name of the skills, plus is 1 if the related skill has sub-skills; to get the sub-skills, id of the related skill with plus attribute as 1 is passed to Step 4. parent_id is the id of the direct parent of the related skill, ancestor_names is the trail of skill categories that lead up to the related skill, separated by the delimiter '<=' with the direct parent on the left and the furthest ancestor on the right, a_ids is the trail of ids of skill categories that lead up to the skill, separated by the delimiter ',' with the direct parent on the left and the furthest id on the right equals 0 which means root.

related_categories array has all the skill categories that are related to the searched skill. id is the id of the related category, skill_name is the name of the related category. If a skill is associated as relation with the searched skill, those skills' categories are given in related_categories and the associated skills' ids are given in child_ids

To get all the skills under a skill category, pass the id of the category in Step 4.



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

Plugin Details

Skills API : Minimum

Plugin Type : Skills Api Calls

Cost per Call : 0.01

Currency : USD

No of Calls : 10,000

Total Amount : $100

Pricing

Plugin Features

  • Search skills from an extensive database
  • Proprietary user interface
  • Access all related categories and skills
  • Rate your skills
  • Add comments to your skills
It's Your Skills

It’s Your Skills combines rich experience in the Human Resources (HR) and capabilities in the cutting edge web technologies to create novel solutions in the global talent space.