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.
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
PricingPlugin Features
- Search roles from predefined Job Skills Profiles
- Search skills from an extensive database
- Proprietary user interface
- Access all related categories and skills
- Rate your skills
- Add comments to your skills