/smartrecruiters/jobs/search

curl --request POST \
  --url https://api.anysite.io/api/smartrecruiters/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "company": "<string>",
  "count": 2,
  "timeout": 300,
  "q": "engineer",
  "country": "us",
  "region": "TX",
  "city": "Austin",
  "department": "868639",
  "custom_field": "57ac0c81e4b06e7ab19310e1:TEC"
}
'

[
  {
    "id": "<string>",
    "@type": "@smart_recruiters_job",
    "name": "<string>",
    "uuid": "<string>",
    "ref_number": "<string>",
    "released_at": "<string>",
    "location": {
      "@type": "@smart_recruiters_location",
      "city": "<string>",
      "region": "<string>",
      "country": "<string>",
      "address": "<string>",
      "postal_code": "<string>",
      "remote": true,
      "hybrid": true,
      "hybrid_description": "<string>",
      "latitude": "<string>",
      "longitude": "<string>",
      "full_location": "<string>"
    },
    "industry": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "function": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "department": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "type_of_employment": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "experience_level": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "language": {
      "@type": "@smart_recruiters_language",
      "code": "<string>",
      "label": "<string>",
      "label_native": "<string>"
    },
    "custom_fields": [],
    "job_ad": {
      "@type": "@smart_recruiters_job_ad",
      "company_description": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      },
      "job_description": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      },
      "qualifications": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      },
      "additional_information": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      }
    },
    "creator": {
      "@type": "@smart_recruiters_creator",
      "name": "<string>",
      "image": "<string>"
    },
    "posting_url": "<string>",
    "apply_url": "<string>",
    "referral_url": "<string>",
    "active": true,
    "visibility": "<string>"
  }
]

/smartrecruiters

/smartrecruiters/jobs/search

List job postings from a company’s SmartRecruiters career board by board handle, optionally narrowed by keyword, country, region, city, department or a custom field. Each posting includes name, reference number, release date, location, industry, function, department, type of employment, experience level, language and custom fields.

Price: 5 credits per 100 results

💡 AI Hint: List the job postings of a specific company’s SmartRecruiters career board. company is the board handle (e.g. Visa), case-insensitive; count is how many postings to return. Optional q (keyword), country, region, city, department and custom_field (fieldId:valueId) filters narrow the results. Each item has id, name, ref_number, released_at, location, industry, function, department, type_of_employment, experience_level, language and custom_fields.

⚠️ Common errors: 412: Company board not found

POST

api

smartrecruiters

jobs

/smartrecruiters/jobs/search

curl --request POST \
  --url https://api.anysite.io/api/smartrecruiters/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "company": "<string>",
  "count": 2,
  "timeout": 300,
  "q": "engineer",
  "country": "us",
  "region": "TX",
  "city": "Austin",
  "department": "868639",
  "custom_field": "57ac0c81e4b06e7ab19310e1:TEC"
}
'

[
  {
    "id": "<string>",
    "@type": "@smart_recruiters_job",
    "name": "<string>",
    "uuid": "<string>",
    "ref_number": "<string>",
    "released_at": "<string>",
    "location": {
      "@type": "@smart_recruiters_location",
      "city": "<string>",
      "region": "<string>",
      "country": "<string>",
      "address": "<string>",
      "postal_code": "<string>",
      "remote": true,
      "hybrid": true,
      "hybrid_description": "<string>",
      "latitude": "<string>",
      "longitude": "<string>",
      "full_location": "<string>"
    },
    "industry": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "function": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "department": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "type_of_employment": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "experience_level": {
      "@type": "@smart_recruiters_label",
      "id": "<string>",
      "label": "<string>"
    },
    "language": {
      "@type": "@smart_recruiters_language",
      "code": "<string>",
      "label": "<string>",
      "label_native": "<string>"
    },
    "custom_fields": [],
    "job_ad": {
      "@type": "@smart_recruiters_job_ad",
      "company_description": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      },
      "job_description": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      },
      "qualifications": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      },
      "additional_information": {
        "@type": "@smart_recruiters_job_ad_section",
        "title": "<string>",
        "text": "<string>"
      }
    },
    "creator": {
      "@type": "@smart_recruiters_creator",
      "name": "<string>",
      "image": "<string>"
    },
    "posting_url": "<string>",
    "apply_url": "<string>",
    "referral_url": "<string>",
    "active": true,
    "visibility": "<string>"
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

company

string

required

Company career-board handle from the careers URL (jobs.smartrecruiters.com/{company})

Minimum string length: 1

Examples:

"Visa"

"BoschGroup"

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

string | null

Full-text keyword query

Example:

"engineer"

country

string | null

Filter by ISO country code

Minimum string length: 1

Example:

"us"

region

string | null

Filter by region / state

Minimum string length: 1

Example:

"TX"

city

string | null

Filter by city

Minimum string length: 1

Example:

"Austin"

department

string | null

Filter by department id

Minimum string length: 1

Example:

"868639"

custom_field

string | null

Filter by a custom field, formatted as fieldId:valueId

Minimum string length: 1

Example:

"57ac0c81e4b06e7ab19310e1:TEC"

Response

Successful Response

string

required

@type

string

default:@smart_recruiters_job

name

string | null

uuid

string | null

ref_number

string | null

released_at

string | null

location

SmartRecruitersLocation · object

Show child attributes

industry

SmartRecruitersLabel · object

Show child attributes

function

SmartRecruitersLabel · object

Show child attributes

department

SmartRecruitersLabel · object

Show child attributes

type_of_employment

SmartRecruitersLabel · object

Show child attributes

experience_level

SmartRecruitersLabel · object

Show child attributes

language

SmartRecruitersLanguage · object

Show child attributes

custom_fields

SmartRecruitersCustomField · object[]

Show child attributes

job_ad

SmartRecruitersJobAd · object

Show child attributes

creator

SmartRecruitersCreator · object

Show child attributes

posting_url

string | null

apply_url

string | null

referral_url

string | null

active

boolean | null

visibility

string | null

/smartrecruiters/jobs /stepstone/jobs