Skip to main content
POST
/
api
/
wttj
/
jobs
/
search
/wttj/jobs/search
curl --request POST \
  --url https://api.anysite.io/api/wttj/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "query": "",
  "language": "en",
  "sort": "relevance",
  "profession_sub_category": "data-business-intelligence-yZjY1",
  "sector_reference": "software-1",
  "experience_level_min": 1,
  "country_code": "FR",
  "organization_alias": "doctolib",
  "latitude": 0,
  "longitude": 0,
  "radius": 2
}
'
[
  {
    "@type": "@wttj_job_search_hit",
    "name": "<string>",
    "alias": "<string>",
    "reference": "<string>",
    "wk_reference": "<string>",
    "summary": "<string>",
    "contract_type": "<string>",
    "remote": "<string>",
    "salary_min": 123,
    "salary_max": 123,
    "salary_currency": "<string>",
    "salary_period": "<string>",
    "experience_level_min": 123,
    "education_level": "<string>",
    "profession": {
      "@type": "@wttj_profession",
      "category_name": "<string>",
      "category_reference": "<string>",
      "sub_category_name": "<string>",
      "sub_category_reference": "<string>",
      "pivot_name": "<string>",
      "pivot_reference": "<string>"
    },
    "sectors": [],
    "key_missions": [],
    "benefits": [],
    "offices": [],
    "organization_name": "<string>",
    "organization_alias": "<string>",
    "organization_image": "<string>",
    "published_at": "<string>",
    "url": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Max number of job postings to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
query
string
default:""

Keyword query

Examples:

"data engineer"

"product manager"

​
language
enum<string>
default:en

Search language and result localization

Available options:
cs,
en,
es,
fr,
sk
​
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
most_recent
​
contract_type
enum<string> | null

Contract type filter

Available options:
full_time,
apprenticeship,
temporary,
internship,
freelance,
part_time,
vie,
graduate_program,
volunteer,
idv,
other
​
remote
enum<string> | null

Remote-work policy filter

Available options:
no,
partial,
punctual,
fulltime,
unknown
​
profession_category
enum<string> | null

Profession category filter

Available options:
sales-customer-service-5MzIw,
tech-engineering-3NjUy,
business-finance-1MjQ4,
project-product-management-xYmEw,
hr-people-iZGMy,
communication-marketing-advertising-wNDg5,
maintenance-repair-lZDUy,
transport-logistics-lMDVm,
craftsmanship-and-manual-labor-yNGQw,
fashion-5MzY5,
healthcare-yMjNi,
hospitality-4ZTdj,
construction-jNzEz,
consulting-strategy-iNDRl,
legal-zYjg3,
agriculture-agri-food-4YmNh,
research-development-0OGVm,
security-defense-jMzJm,
education-wNTkx,
culture-arts-wOTc2
​
profession_sub_category
string | null

Profession sub-category reference filter (facet code), e.g. data-business-intelligence-yZjY1

Example:

"data-business-intelligence-yZjY1"

​
sector
enum<string> | null

Parent industry/sector filter

Available options:
tech-1,
industry-1,
banking-insurance-finance,
distribution-1,
consulting-audit,
health-social-environment,
culture-media-entertainment,
advertising-marketing-agency,
public-administration-1,
food-and-beverage,
engineering-1,
education-training-recruitment,
real-estate,
fashion-luxury-beauty-lifestyle,
mobility-transport,
hotel-tourism-leisure,
corporate-services,
nonprofit-association,
architecture-1,
legal-law
​
sector_reference
string | null

Specific sector reference filter (facet code), e.g. software-1

Example:

"software-1"

​
experience_level_min
number | null

Minimum years of experience filter

Required range: x >= 0
​
education_level
enum<string> | null

Education level filter

Available options:
no_diploma,
cap,
bep,
bac,
bac_1,
bac_2,
bac_3,
bac_4,
bac_5,
phd
​
country_code
string | null

Office country ISO alpha-2 code filter, e.g. FR

Example:

"FR"

​
organization_alias
string | null

Restrict to one company by its alias

Example:

"doctolib"

​
latitude
number | null

Latitude for geo radius search

Required range: -90 <= x <= 90
​
longitude
number | null

Longitude for geo radius search

Required range: -180 <= x <= 180
​
radius
integer | null

Geo search radius in meters

Required range: x >= 1

Response

Successful Response

​
@type
string
default:@wttj_job_search_hit
​
name
string | null
​
alias
string | null
​
reference
string | null
​
wk_reference
string | null
​
summary
string | null
​
contract_type
string | null
​
remote
string | null
​
salary_min
integer | null
​
salary_max
integer | null
​
salary_currency
string | null
​
salary_period
string | null
​
experience_level_min
number | null
​
education_level
string | null
​
profession
WttjProfession · object
​
sectors
WttjSectorEntity · object[]
​
key_missions
string[]
​
benefits
string[]
​
offices
WttjOffice · object[]
​
organization_name
string | null
​
organization_alias
string | null
​
organization_image
string | null
​
published_at
string | null
​
url
string | null