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.
Feedback