Zijob - API - Parameters

Account Parameters

account_company_name

Description : Name of the company of the account holder
Type : String (1-255 characters)
Example : Aliva SA

account_company_type

Description : Type of the company of the account holder

id

Description : Unique ID of the company type
Type : Integer
Example : 1

value

Description : Value of the company type
Type : String
Example : Entreprise
Values : you can get account company type values by using accountcompanytype/list

account_company_vat

Description : VAT number of the company of the account holder
Type : String (0-255 characters)
Example : FR814556565

account_creation_date

Description : Creation date of the account
Type : date
Example : 2009-10-06 08:48:59br/>

account_id

Description : Unique identifiant of the account
Type : Integer
Example : 1234

account_email

Description : Email of the account holder(unique)
Type : String (1-100 characters) - email formarting
Example : test@test.com

account_firstname

Description : Firstname of the account holder
Type : String (1-100 characters)
Example : david

account_lastname

Description : Lastname of the account holder
Type : String (1-100 characters)
Example : smith

account_password

Description : Password of the account
Type : String (5-30 characters)
Example : xv154SDF2

account_phone

Description : Main phone of the account holder
Type : String (0-255 characters)
Example : 0465-123-456

account_promocode

Description : Promotion code (add free credits to a new user account)
Type : String (0-255 characters)
Example : PROMO

account_status

Description : Status of the account

id

Description : Unique ID of the status
Type : Integer
Example : 20

value

Description : Value of the status
Type : String
Example : pending for moderation

account_update_date

Description : Date of the last account update
Type : date
Example : 2009-10-06 08:48:59

Candidate Parameters

candidate_availability

Description : Availability in months (0 means immedially available)
Type : integer
Example : 3 (which means that the candidate will be available in 3 months)

candidate_language

Description : Language

id

Description : Unique ID of the language
Type : Integer
Example : 6

value

Description : Name of the language
Type : String
Example : Français
Values : you can get language values by using candidatelanguage/list

candidate_languagelevel

Description : Candidate language lvel

id

Description : Unique ID of the language level
Type : Integer
Example : 4

value

Description : Value of the language level
Type : String
Example : Bilingue
Values : you can get language level values by using candidatelanguagelevel/list

candidate_languages

Description : List of languages and associated language level spoken by the candidate
Type : String (0-255 characters) : candidate_language_id/candidate_languagelevel_id,candidate_language_id/candidate_languagelevel_id
Example : 1:2,2:1 (means that candidates speaks languages id=1 with level id=2 and language id=2 with level id=1)
Values : you can get language values by using candidatelanguage/list and language level values by using candidatelanguagelevel/list

candidate_qualification

Description : Candidate Qualification

id

Description : Unique ID of the candidate qualification
Type : Integer
Example : 5

value

Description : Value of the candidate qualification
Type : String
Example : Ingénieur / Cadre (Bac +5)
Values : you can get qualification values by using candidatequalification/list

Company Parameters

company_anonymous

Description : Name of the company is hidden if anonymous=1
Type : boolean (0:default)
Example : 1

company_creation_date

Description : Creation date of the company
Type : date
Example : 2009-10-06 08:48:59br/>

company_description

Description : Description of the company
Type : String (0-65535 characters)
Example : Aldavia is a leading name in the financial services industry...

company_employee

Description : Company employee's number range or value
Type : String
Example : 500-999 or 853

company_id

Description : Unique identifiant of a company
Type : Integer
Example : 1234

Description : Company Logo
Type : HTTP Post Data or URL (GIF, JPG or PNG file less than 2 MB)
Example : http://www.domain.com/company/12/logo.jpg

tiny

Description : url of the tiny image (jpg - max 40px*30px)
Type : String (url)
Example : http://www.zijob.com/public/images/up/tiny/0807/8127e74053b0a266aafbea17eaaa9587.jpg

small

Description : url of the small image (jpg - max 120px*50px)
Type : String (url)
Example : http://www.zijob.com/public/images/up/small/0807/8127e74053b0a266aafbea17eaaa9587.jpg

medium

Description : url of the medium size image (jpg - max 300px*240px)
Type : String (url)
Example : http://www.zijob.com/public/images/up/medium/0807/8127e74053b0a266aafbea17eaaa9587.jpg

big

Description : url of the big image (jpg - max 500px*400px)
Type : String (url)
Example : http://www.zijob.com/public/images/up/big/0807/8127e74053b0a266aafbea17eaaa9587.jpg

company_name

Description : Name of the company
Type : String (1-255 characters)
Example : Aldavia SA

company_reference

Description : Intern reference of the company (specified by the recruiter)
Type : String (0-255 characters) - Unique for a given recruiter
Example : ALV4554

company_revenue

Description : Company revenue range or value (in local currency)
Type : String
Example : 500000-1000000 or853000

company_status

Description : Status of the company

id

Description : Unique ID of the company status
Type : Integer
Example : 20

value

Description : Value of the company status
Type : String
Example : Active

company_update_date

Description : Date of the last company update
Type : date
Example : 2009-10-06 08:48:59br/>

company_website

Description : URL of the company website
Type : String (url - 0-255 characters - must start with http:// or https://)
Example : http://www.avila.com

CV Parameters

cv_description

Description : Description of candidate CV - it could be a description of the candidate or any keywords about candidate education, experiences or skills. These keywords will be used to index the CV (CV Database search engine)
Type : String (0-65535 characters)
Example : Centrale Paris 2003, PHP 5, XHTML, Javascript...

cv_file

Description : Candidate CV File
Type : HTTP Post Data or URL (Doc or PDF file less than 2 MB)
Example : http://www.domain.com/cv/121121545.pdf

Job Parameters

job_category

Description : Category of the job (Three-levels system)

id

Description : Unique ID of the job category
Type : Integer
Example : 001100020040

value

Description : Value of the job category
Type : String
Example : Logistic Director
Values : you can get job category values by using jobcategory/list

job_creation_date

Description : Creation date of the job
Type : date
Example : 2009-10-06 08:48:59br/>

job_description

Description : Description of the job position
Type : String (0-65536 caracters)
Example : The role of Middle Office Assistant offers an excellent opportunity to work in a challenging, rewarding and entrepreneurial environment...

job_email_application

Description : Email that receives the application (leave empty if you want the application to be sent to account's email
Type : String (0-255 characters)
Example : email@domain.com

job_experience

Description : Experience range or value (in year(s))
Type : String (0-50 characters)
Example : 5-10 or 6

job_id

Description : Unique identifiant of a job
Type : Integer
Example : 1234

job_locations

Description : List of available locations for a job
Type : String (0-255 characters) : formed by a combination of (postalcode,subadminarea,adminarea,country) with correspondant IDs
Example : postalcode:75007,postalcode:75006;subadminarea:75,adminarea:11,country:1
Values :you can get subadminarea,adminarea,country IDs by checking location parameters

job_profile

Description : Description of the candidate's profile
Type : String (0-65536 characters)
Example : We are looking for a very motivated and entrepreneur candidate...

job_reference

Description : Intern reference of the job (specified by the recruiter)
Type : String (0-255 characters) - Unique for a give recruiter
Example : XBS4554

job_salary

Description : Salary range or value (in local currency / per year)
Type : String (0-50 characters)
Example : 20000-30000 or 50000

job_status

Description : Status of the job

id

Description : Unique ID of the job status
Type : Integer
Example : 10

value

Description : Value of the job status
Type : String
Example : Pending for moderation

job_title

Description : Title of the job
Type : Text (1-64 caracters)
Example : Marketing Director - Bilingual

job_type

Description : Type of job's contract

id

Description : Unique ID of job type
Type : Integer
Example : 5

value

Description : Value of job type
Type : String
Example : Stage
Values : you can get job type values by using jobtype/list

job_update_date

Description : Date of the last job update
Type : date
Example : 2009-10-06 08:48:59br/>

job_url

Description : URL of the job on Zijob (only for online jobs)
Type : String (url)
Example : http://www.zijob.fr/1/emploi/test3/nancy<

job_url_application

Description : URL of the application form for a job (it could be on Zijob or on an extern website)
Type : String (url)
Example : http://www.zijob.fr/1/emploi/test3/nancy#form

Job Search Parameters

jobsearch_keyword

Description : Keywords to be used for search (job title, job description, company description, company name, location)
Type : String (0-255 characters)
Example : Marketing CDI Paris

jobsearch_limit

Description : Maximum number of jobs returned
Type : Integer (1-100) - default : 10
Example : 20

jobsearch_location

Description : Locations to be used for search (admin area, subadmin area, postal code, zip code, city)
Type : String (0-255 characters)
Example : Paris

jobsearch_number

Description : Total number of matching jobs found
Type : Integer
Example : 234

jobsearch_offset

Description : Offset (for page per page display)
Type : Integer
Example : 50 (will return jobs from the 50th results)

jobsearch_orderby

Description : Job Search Order
Type : Formated String (relevancy,date) - default:relevancy
Example : date

Location Parameters

location_address

Description : Adress of the location
Type : String (0-255 characters)
Example : 47 Diego Street

location_adminarea

Description : Admin area of the location (regions for France, states for USA

id

Description : Unique ID of admin area
Type : Integer
Example : 42

value

Description : Value of admin area
Type : String
Example : Alsace
Values : you can get admin area values by using locationadminarea/list

location_city

Description : City of the location
Type : String (0-255 characters)
Example : Marketing Director

location_country

Description : country of the location

id

Description : Unique ID of the country
Type : Integer
Example : 13

value

Description : Name of the country
Type : String
Example : Argentina
Values : you can get location country names by using locationcountry/list

location_postalcode

Description : Zipcode of the location
Type : String (0-255 characters)
Example : 10003

location_subadminarea

Description : Subadmin area of the location (departments for France, counties for USA

id

Description : Unique ID of subadmin area
Type : Integer
Example : 12

value

Description : Value of subadmin area
Type : String
Example : Aveyron
Values : you can get subadmin area values by using locationsubadminarea/list

Response Parameters

response_creation_date

Description : Create date of the response
Type : date
Example : 2009-10-06 08:48:59

response_error

Description : Error message

code

Description : Error code
Type : Integer (see error messages list)
Example : 544

message

Description : Error message
Type : String
Example : Company name is mandatory

response_format

Description : Format of the response
Type : Formated String (XML,Array, Json) - default : XML more information on formats
Example : Json

response_language

Description : language of the response
Type : string
Example : fr_FR

response_status

Description : Status of the response

code

Description : Unique ID of the response status
Type : Integer (200,400)
Example : 200

message

Description : Value of the response status
Type : String (Success,Failed)
Example : Success

response_time

Description : Execution time of the query
Type : float (second)
Example : 0.01