TalentBin API Documentation
SEARCH method
1. Request Format
http://api.talentbin.com:8080/v1/profile/search?apikey=<key>&<params>
2. Request Parameters
Parameters: Each search parameter value may be a search term or a comma-separated list of search terms.
name:
The name of the candidate you are trying to find.
location:
eg. sf bay area, australia, nyc
role:
eg. software engineer, dba, product manager, cto, vp of sales
company:
eg. google, apple, amazon, mckinsey
school:
eg. stanford, brown, princeton
skills:
eg. ruby, php, ui design, html5
keywords:
Keywords will be searched against all candidate profile fields in our database.
Pagination: Search results are defaulted to 20 results.
start:
Starting index of search result.
results:
Number of search results to get (maximum of 100)
Advanced: You may alter the default search operators and response detail level and format.
roleop:
[and | or | lucene] Specifies the operator when comma-separated role terms. Default: or. Use lucene to send the untranslated role value as the search term.
skillsop:
[and | or | lucene] Specifies the operator when comma-separated skill terms. Default: or. Use lucene to send the untranslated skills value as the search term.
viewtype:
[full | summary | id] Different levels of detail. Default: summary
format:
[json | xml | jsonp] Default: json
Sample search requests:
Search by name:
http://api.talentbin.com:8080/v1/profile/search?apikey=<key>&name=jason+heidema
Search by location and role:
http://api.talentbin.com:8080/v1/profile/search?apikey=<key>&location=san+francisco&role=cto,vp+eng,director+of+engineering
Search by location and skills with AND operator:
http://api.talentbin.com:8080/v1/profile/search?apikey=<key>&location=new+york&skills=gwt,java,j2ee,hibernate,springframework&skillsop=and
Search by role with LUCENE syntax:
http://api.talentbin.com:8080/v1/profile/search?apikey=<key>&role=((qa+manager)^5+OR+qa)+AND+selenium&roleop=lucene
3. Response
The response format is determined by the format request param (json, xml, jsonp). The default format is json.
{
numFound: 79,
profiles: [
{
id: 2384449332491734,
name: "Jason Heidema",
headline: "Co-Founder, CEO at TalentBin",
summary: "Evolving social recruiting",
location: "SF Bay Area",
pictureUrl: "http://d2o7bfz2il9cb7.cloudfront.net/main-thumb-253740-100-5hYgHdm6vfAF59TVeDQP3LUMh7jR7xGc.jpeg",
talentbinUrl: "http://www.talentbin.com/profile/2384449332491734",
otherInterests: [ {"interest": "sports betting"}, {"interest": "poker"}, ...],
professionalInterests: [ {"interest": "general management"}, {"interest": "product strategy"}, ...],
jobHistory: [
{
"title": "Co-Founder, CEO",
"company": "TalentBin",
"from": "May 2011"
},
{
"title": "Group Product Manager",
"company": "eBay",
"from": "January 2002"
"to": "January 2008",
},
...
],
educationHistory: [
{
"school": "Stanford",
"field": "Symbolic Systems",
"from": "1998"
"to": "2002",
},
{
"school": "Overland High School",
"to": "1998",
},
...
],
contactVectors: [
{
"network": "quora",
"url": "http://www.quora.com/jason-heidema"
},
{
"network": "googleplus",
"url": "http://plus.google.com/113750253535841556650/about"
},
...
],
webProfiles: [
{
"url": "http://www.facebook.com/heidema"
},
{
"url": "http://twitter.com/propapapa"
},
...
]
},
{...},
{...}
]
}
GET method
1. Request Format
http://api.talentbin.com:8080/v1/profile/get?apikey=<key>&id=<profileid>
2. Request Parameters
Parameters:
id:
The profile identifier or a comma-delimited list of profile identifiers (max 50).
Advanced: You may alter the response detail level and format.
viewtype:
[full | summary | id] Different levels of detail. Default: full
format:
[json | xml | jsonp] Default: json
Sample get request:
http://api.talentbin.com:8080/v1/profile/get?apikey=<key>&id=2384449332491734
http://api.talentbin.com:8080/v1/profile/get?apikey=<key>&id=2384449332491734,1389129084743065
3. Response
The response format is determined by the format request param (json, xml, jsonp). The default format is json.
profiles: [
{
id: "1052696322009169",
name: "Gabriel Smith",
location: "SF Bay Area",
headline: "Engineer at Facebook",
summary: "My goal is to do interesting work.",
pictureUrl: "http://a1.twimg.com/profile/17071732/Smith-md_normal.jpg",
talentbinUrl: "http://www.talentbin.com/profile/1052696322009169",
educationHistory: [
{
school: "Main State University",
field: "Computer Science",
degree: "Bachelor of Science",
summary: "SIPB group",
from: "1992",
to: "1997"
},
{
school: "Modern American School",
degree: "High School"
}
],
jobHistory: [
{
company: "Facebook",
title: "Engineer",
summary: "I make stuff",
from: "July 2008"
},
{
company: "Craigslist",
title: "Software Engineer",
industry: "Internet",
summary: "I'm working on whatever needs doing.",
from: "July 2006"
to: "October 2008"
}
],
professionalInterests: [
{
interest: "Perl",
weight: 340
},
{
interest: "Python",
weight: 208
},
{
interest: "C",
weight: 116
}
],
otherInterests: [
{
interest: "Space Exploration",
weight: 11
},
{
interest: "Lucha Libre",
weight: 2
}
],
webProfiles: [
{
label: "linkedin",
domain: "linkedin.com",
url: "http://www.linkedin.com/in/gabsmith"
},
{
label: "googleplus",
domain: "profiles.google.com",
url: "http://profiles.google.com/gabsmith"
}
{
label: "gravatar",
domain: "gravatar.com",
url: "http://gravatar.com/gabsmith"
}
],
contactVectors: [
{
contact: "http://www.facebook.com/messages/gabsmith",
label: "facebook"
},
{
contact: "gabsmith@example.com",
label: "email"
},
{
contact: "http://twitter.com/intent/tweet?text=@gabsmith",
label: "twitter"
}
]
}
]
Lucene Syntax
Escape search terms to lucene syntax to construct more advanced search queries. Check out the lucene documentation for more information.