Bayt API: Search jobs (v1)

Returns one page of 30 Bayt jobs with company, city and country, the pay band where the employer shows one, career level, Bayt's summary and posting time; at most 334 pages per search. A query nothing matches returns no results and a total of 0.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

A job title, skill or keyword, such as accountant, site engineer or c++ developer.

Length1 <= length <= 200

location?string

A country such as UAE, Saudi Arabia, Qatar or Egypt; a city Bayt lists such as Dubai, Riyadh, Doha or Cairo; or City, Country for any other city, such as Salalah, Oman. Omit to search every country. Other values are rejected.

Lengthlength <= 120

Default""

page?integer

One-based page of 30 jobs. Bayt lists at most 334 pages (about 10,000 jobs) for one search. A page past the last one returns empty results with stop_reason set to past_last_page.

Range1 <= value <= 334

Default1

sort?string

relevance (the default, as on bayt.com) or date for the newest postings first.

Default"relevance"

Value in

"relevance"
"date"

posted_within_days?integer

Keep only jobs posted in the last 1, 7 or 30 days, Bayt's own date filters. Other values are rejected.

curl -X GET "https://example.com/v1/bayt/search?query=accountant" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "accountant",    "location": "Dubai",    "country": "uae",    "city": "dubai",    "page": 1,    "sort": "relevance",    "posted_within_days": null,    "total": 273,    "total_is_estimate": true,    "page_size": 30,    "max_page": 10,    "has_more": true,    "count": 0,    "url": "https://www.bayt.com/en/uae/jobs/accountant-jobs-in-dubai/",    "stop_reason": null,    "results": [      {        "job_id": "5504825",        "title": "Sr. Accountant -General Accountant",        "url": "https://www.bayt.com/en/uae/jobs/sr-accountant-general-accountant-5504825/",        "company": {          "name": "Brentta General Trading LLC",          "id": "2327243",          "url": "https://www.bayt.com/en/company/brentta-general-trading-llc-2327243/",          "logo_url": "https://secure.b8cdn.com/70x70/images/logo/43/2327243_logo_1793800062_n.png"        },        "is_confidential_company": true,        "location": "Dubai, UAE",        "city": "Dubai",        "country": "UAE",        "salary": {          "label": "AED 5,509 - AED 7,345",          "min": 5509,          "max": 7345,          "currency": "AED"        },        "career_level": "Mid career",        "experience": {          "min_years": 4,          "max_years": 5,          "label": "4-5 Years of Experience"        },        "summary": "string",        "posted_at": "2026-11-05T09:11:56Z",        "is_easy_apply": true,        "is_featured": true      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}