ToolzerHub Docs

Search jobs (v1)

Returns one page of 25 GulfTalent jobs with company, city and country, category, industry, seniority, employment type and posting time. Pages run to the last matching job. A query nothing matches returns no results and a total of 0.

1 credit / requestBilled only on success
GET
/v1/gulftalent/search

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

query*string

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

Length1 <= length <= 200
location?string

A country such as UAE, Saudi Arabia, Qatar or Egypt, or a city GulfTalent lists such as Dubai, Abu Dhabi, Riyadh, Doha or Cairo. Omit to search every country. Other values are rejected.

Lengthlength <= 120
Default""
page?integer

One-based page of 25 jobs. Pages run to the last job; a page past it returns empty results with stop_reason set to past_last_page.

Range1 <= value <= 2000
Default1
sort?string

date (the default, as on gulftalent.com) lists the newest postings first. relevance keeps closer to the query but surfaces older postings.

Default"date"

Value in

  • "date"
  • "relevance"
curl -X GET "https://example.com/v1/gulftalent/search?query=accountant" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "query": "accountant",    "location": "Abu Dhabi",    "page": 1,    "sort": "date",    "total": 382,    "page_size": 25,    "max_page": 16,    "has_more": true,    "count": 0,    "url": "https://www.gulftalent.com/jobs/search?keywords=accountant",    "stop_reason": null,    "results": [      {        "job_id": "618180",        "title": "Accountant",        "url": "https://www.gulftalent.com/uae/jobs/accountant-618180",        "company": {          "name": "International Vision Investments - IVI",          "id": "12516",          "url": "https://www.gulftalent.com/companies/international-vision-investments-ivi-careers",          "logo_url": "string"        },        "is_confidential_company": true,        "location": "Abu Dhabi, UAE",        "city": "Abu Dhabi",        "country": "UAE",        "category": "Accounting & Audit",        "industry": "Audit & Accountancy",        "seniority": "Experienced professional",        "employment_type": "Full-time",        "posted_at": "2026-11-05T05:20:00Z",        "is_remote": true,        "is_easy_apply": true,        "is_aggregated": true      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}