Search

Search CV by keywords and filters

For optimization purpose, we are changing the results returned by the search method. We have, right now, two different formats : the old format (called "full response") and the new format (called "light response"). The light response format do not return the CV datas, as well as some other informations (you are still able to access theses datas by doing additional requests). The full search response still works but should be considered as deprecated.

If you want to upgrade your application to match the light response, you can add the "?light=1" parameter at the end of your request. We strongly encourage you to do so.When the transition is be over, we will simply mute this parameter so every request with or without this parameter will return the light response format. An example of the new response is given at the end of this document.

No transition date has been announced as we are working with our partners one by one to ensure the transition goes smoothly.

Note The search will apply on the users who have authorized your application.

Access

POST https://api.doyoubuzz.com/search/?apiKey=:apiKey &light=1 - during the transition period, add the light parameter to get the new response format

 

Attributes

The attributes are given in XML in the POST body. The attributes below are wrapped in a <search> tag (see example).

 

Name Description
queries All the query terms (default: no query).
query A query description. You can have several queries on one search request: if you use several termes, the search matches all query words.
term The word(s) to search on. Please also see available operators.
fields List of fields to apply the search on.
in Name of the field (see available fields).
filters List of the filters to apply on the request.
filter Filter description
name Filter name (see available filters).
min If you want to use a filter as a range filter, minimum value.
max If you want to use a filter as a range filter, maximum value.
values If you want to use an exact match filter, specify the value(s)
value Value for the exact match filter (integer)
geo Limit the search on the users who agree to work in a specific location. On DoYouBuzz the user can select one or several countries and / or one or several cities with a perimeter for each city. For example if the user chooses Paris with a perimeter of 50 kilometers, then he will match a search on Versailles or any other city or GPS location in a 50km perimeter of Paris.
cities Limit the search with cities criteria (if you send several cities, the operator applied will be AND, meaning the user matching both cities will be returned by the search)
city City criteria
country Country ISO 3166 code
zipcode City zipcode (only FR cities works for now)
coordinates GPS coordinates criteria
coordinate GPS coordinates
latitude Coordinate latitude
longitude Coordinate longitude
metadatas Filter the search on a metadata (you need to have previsouly assigned metadatas to your users. Please see the metadatas documentation.
metadata

One metadata to filter the result on.

Prefix with "!" to get the users who have not the given key.

A soft-delete system is used on the users. To get users who have deleted their account, filter with the key : status:user_deleted. To get the user whose account have been deleted by the company, filter with the key: !status:company_deleted.

The following filter will return undeleted users :

					
				    	!status:user_deleted
				    	!status:company_deleted
					
				
index

Resumes data are stored on 3 different kind of indexes: one per language (general_fr_FR and general_en_US), and one for private resume database (general_private). The index general_fr_FR is used by default.

If you use DoYouBuzz Showcase as a private resume database, you will need to use specifically this index.

limits Limits to apply on the request.
Offset
Limit

Available fields & options

List of available query fields

name Search in the firstname and lastname of the users
cv Search in the CV Title, presentation text and short cv description
jobs Search in the job title, job description, job company and job mission description
skills Search in skills title and description
educations Search in educations title, diploma and description
location Search in the city (as seen on the CV)

List of available search operators

Name Syntax Example
OR | hello | world
NOT ! hello !world
Phrase search operator "phrase" “hello world”
Proximity search operator.
Proximity distance is specified in words, adjusted for word count, and applies to all words within quotes. For instance, "cat dog mouse"~5 query means that there must be less than 8-word span which contains all 3 words, ie. "CAT aaa bbb ccc DOG eee fff MOUSE" document will not match this query, because this span is exactly 8 words long.
"term"~number “hello world”~10

List of available filter names

Name Description
position The position seeked by user. Please refer to Baseslist.
business The business sector in wich the user works. Please refer to Baseslist.
completion Completion rate of the CV, between 0 and 100
contract The contract the user specified in his employment preferences. Please refer to Baseslist.
educationLevel The education level of the user. Please refer to Baseslist.
grossSalaryMin The minimal gross salary. Please refer to Baseslist.
grossSalaryMax The maximum gross salary. Please refer to Baseslist.
seniority The seniority of the user. Please refer to Baseslist.
freshness The freshness (in days) since the CV last update.
availability The availability (as seen on the CV).
professional_status The professional_status (as seen on the CV).
created_since The number of day since the creation of the CV.
group The group’s ID the user belong to. Eligible for partners only.
alumni Wether or not the user is an alumni. Eligible for partners only.

Request example

	
		
			
				PHP
				
					cv
					jobs
					educations
				
			
		
		
			
				seniority
				1
				5
			
			
				professional_status
				
					1
				
			
		
		general_en_US
		
			
                
                    FR
                    44000
                
			
			
                
                    47.213520
                    -1.561381
                
			
			
		
    		tag:12
			
		
			0
			10
		
	

Response example (for the light request)

This is the new, lighter and more optimized response, returned if you add the "light?=1" parameter on your request.

   
       
           270627
           
               678
               680
               Développeur PHP
               fr_FR
               
1
0.85 2013-02-06T14:53:59 4 1 1 1 2570 Développeur PHP Onlineformapro Vesoul 2005-01-31 1
1
1 1 0 10

Response example (for the full request)

Hey Yo! We kindly remind you that this response is deprecated, you may go the wrong way if you are about to use this response format.

	
  		
			50575
			
      			... See CV details ...
    		
  		
 	
 	3
 	3
 	0
 	10