API Reference

This endpoint allows you to find companies and their recruitments based on current or post jobs filters.

Jobs aggregation

The job postings matching your targeting criteria are grouped by companies.

By default all job boards are activated meaning you can receive jobs from different job boards.

Each companies will contains all job postings matching your criteria

Searching using keywords as exact match

As you filter jobs based on job title or job description, keep in mind filters are keywords based and provide an exact match.

For instance, looking for job title "sales" will match job titles "sales manager" or "senior sales" but not "business developer".

Punctuation is not necessary inside the search: for instance the string "é" is replaced by "e", the string "-" is replaced by " ".

Dealing with boolean search with keywords

By default, multiple keywords to find in the job title or job description will use a "OR" between them: querying in the job title "sales" and "business developer" will get jobs matching "sales" or "business developer" inside the job title.

You can control this behavior using job_title_include_all _or _job_description_include_all to have an "OR" or "AND" between keywords to find.

Excluding keywords

Keywords exclusion have always an "OR" logic between them: excluding "internship" and "junior" from the job title will automatically exclude jobs containing either "internship" OR "junior inside the job title.

Companies filtering

You can optionally filter the companies matching your criteria on jobs. Several filters can be used: company size, company industry.

If you need to filter companies based on their industries, please refer to the section Reference > Industry reference.

Credit consumption

Each company found matching your criteria on recruitment and companies consumes a credit.

The credits consumed doesn't depend of the number of jobs matched but only the number of companies matching.

Language
Credentials
Header
Click Try It! to start a request and see the response here!