# JobStreet API — jobs in Malaysia, Singapore, the Philippines and Indonesia: search JobStreet (my/sg/ph/id.jobstreet.com) by keyword, location, classification, job type, remote/hybrid, salary and date; full job detail with description, salary, applicant count and screening questions; company profiles, employee reviews, salaries and open jobs; career-guide roles with salary by region; location and keyword suggestions — no login

> Search JobStreet jobs in one market (MY, SG, PH or ID) with every filter the site offers: keywords, location (+ radius), classification / sub-classification, job type, work arrangement, salary range (monthly/annual/hourly), date posted, advertiser, sort. Real pagination with the site's total, up to 100 jobs per page, plus classification counts and related searches for the same query.
> ReefAPI engine `jobstreet` · 16 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/jobstreet/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/jobstreet/v1/search — 1 credit
Search JobStreet jobs in one market (MY, SG, PH or ID) with every filter the site offers: keywords, location (+ radius), classification / sub-classification, job type, work arrangement, salary range (monthly/annual/hourly), date posted, advertiser, sort. Real pagination with the site's total, up to 100 jobs per page, plus classification counts and related searches for the same query.

**Parameters:**
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `keywords` (string, optional) — Job title, skill or company words. Optional: leave empty to list every job in the market (with filters).
- `location` (string, optional) — City, suburb, state or region in the chosen country, as the site types it ('Kuala Lumpur', 'Petaling Jaya', 'Cebu', 'Jakarta Raya', 'Central Region'). location-suggest returns exact names and ids.
- `location_id` (string, optional) — Numeric location id from location-suggest (exact match, overrides location).
- `distance_km` (integer, optional) — Radius around a suburb-level location (0 = that suburb only). Ignored by the site for state/region-level locations.
- `classification` (array, optional) — Classification id(s) or name(s) from the classifications action (e.g. 6281 or 'Information & Communication Technology'). Several = OR.
- `subclassification` (array, optional) — Sub-classification id(s) or name(s), e.g. 6287 = Developers/Programmers.
- `job_type` (array, optional) — One or more of full_time, part_time, contract, casual. [one of: full_time, part_time, contract, casual]
- `work_arrangement` (array, optional) — One or more of onsite, hybrid, remote. [one of: onsite, hybrid, remote]
- `salary_min` (integer, optional) — Minimum pay in the market's currency (MYR/SGD/PHP/IDR), per salary_type.
- `salary_max` (integer, optional) — Maximum pay in the market's currency, per salary_type.
- `salary_type` (enum, optional, default "monthly") — Period the salary_min/salary_max numbers are in. [one of: monthly, annual, hourly]
- `date_posted` (enum, optional) — Only jobs listed in the last N days. [one of: 1, 3, 7, 14, 31]
- `sort` (enum, optional, default "relevance") — Result order. [one of: relevance, date]
- `page` (integer, optional, default 1) — Result page. meta.pagination says how many there are.
- `page_size` (integer, optional, default 30) — Jobs per page (the site uses 30; up to 100).
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]
- `advertiser_id` (array, optional) — Only jobs posted by this advertiser id (advertiser.id on any job).
- `organisation_id` (array, optional) — Only jobs of this organisation id (company.organisation_id on any job).
- `company_name` (string, optional) — Only jobs whose organisation name is exactly this (e.g. 'J&T Express').

**Returns:** jobs[]{job_id, title, url, teaser, advertiser{id,name}, company{organisation_id, name, company_profile_id, profile_url}, location, location_id, country_code, location_hierarchy[], classifications[]{id,label}, work_types[]{id,label}, work_arrangements[], salary{label, min, max, currency, period, hidden_by_employer}, bullet_points[], logo_url, posted_at, posted_relative, tags[], badges[], role_titles[], recruiters[]} + total + classification_counts[] + related_searches[] + location_matched[] + company_suggestion + meta.pagination

**Example request body:**
```json
{
  "country": "MY",
  "keywords": "developer"
}
```

### POST https://api.reefapi.com/jobstreet/v1/detail — 1 credit
Full JobStreet job ad by job_id or URL: description (text + HTML), salary label, work type and arrangement, classification ids, full location breakdown, applicant count and CV / cover-letter percentages, screening questions, apply link, phone/e-mail found in the ad, advertiser (verified, registered since) and the employer's company profile with rating, review count and perks.

**Parameters:**
- `job_id` (string, optional) — JobStreet job id — job_id from search, or the number in <market>.jobstreet.com/job/<id>.
- `url` (string, optional) — A JobStreet job URL instead of job_id.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]

**Returns:** job{job_id, country, title, url, status, is_expired, posted_at, expires_at, teaser, description_text, description_html, salary{label,currency_label}, work_types[], work_arrangements[], classification{id,name,subclassification_id,subclassification}, location{label,suburb,region,state,postcode,country,country_code,area,location_ids}, bullet_points[], screening_questions[], applicants{count,count_label,volume_band,with_resume_percent,with_cover_letter_percent}, apply{url,is_external,restriction}, contact{phone_number,matches[]}, advertiser{id,name,is_verified,registered_at}, company{company_profile_id,name,slug,url,industry,size,website,description,rating,review_count,perks_and_benefits[]}, company_tags[], badges[], branding, video}

**Example request body:**
```json
{
  "job_id": "95835138"
}
```

### POST https://api.reefapi.com/jobstreet/v1/batch-detail — 2 credits
Full detail for up to 10 JobStreet jobs in ONE upstream request (same fields as detail). Missing or expired ids come back in not_found[].

**Parameters:**
- `job_ids` (array, required) — Up to 10 job ids (comma-separated or a list).
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]

**Returns:** jobs[] (detail shape) + not_found[] + requested

**Example request body:**
```json
{
  "job_ids": "95835138,95667394"
}
```

### POST https://api.reefapi.com/jobstreet/v1/company-jobs — 2 credits
Every open JobStreet job of one company, with the same filters, sort and pagination as search. Pass the company profile id / slug / URL, or the organisation_id from any job.

**Parameters:**
- `company` (string, optional) — Company profile id (168551397678682), slug (petronas-168551397678682) or JobStreet company URL — company.company_profile_id on any job, or company-search.
- `organisation_id` (array, optional) — Only jobs of this organisation id (company.organisation_id on any job).
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `keywords` (string, optional) — Job title, skill or company words. Optional: leave empty to list every job in the market (with filters).
- `location` (string, optional) — City, suburb, state or region in the chosen country, as the site types it ('Kuala Lumpur', 'Petaling Jaya', 'Cebu', 'Jakarta Raya', 'Central Region'). location-suggest returns exact names and ids.
- `location_id` (string, optional) — Numeric location id from location-suggest (exact match, overrides location).
- `distance_km` (integer, optional) — Radius around a suburb-level location (0 = that suburb only). Ignored by the site for state/region-level locations.
- `classification` (array, optional) — Classification id(s) or name(s) from the classifications action (e.g. 6281 or 'Information & Communication Technology'). Several = OR.
- `subclassification` (array, optional) — Sub-classification id(s) or name(s), e.g. 6287 = Developers/Programmers.
- `job_type` (array, optional) — One or more of full_time, part_time, contract, casual. [one of: full_time, part_time, contract, casual]
- `work_arrangement` (array, optional) — One or more of onsite, hybrid, remote. [one of: onsite, hybrid, remote]
- `salary_min` (integer, optional) — Minimum pay in the market's currency (MYR/SGD/PHP/IDR), per salary_type.
- `salary_max` (integer, optional) — Maximum pay in the market's currency, per salary_type.
- `salary_type` (enum, optional, default "monthly") — Period the salary_min/salary_max numbers are in. [one of: monthly, annual, hourly]
- `date_posted` (enum, optional) — Only jobs listed in the last N days. [one of: 1, 3, 7, 14, 31]
- `sort` (enum, optional, default "relevance") — Result order. [one of: relevance, date]
- `page` (integer, optional, default 1) — Result page. meta.pagination says how many there are.
- `page_size` (integer, optional, default 30) — Jobs per page (the site uses 30; up to 100).
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]

**Returns:** jobs[]{job_id, title, url, teaser, advertiser{id,name}, company{organisation_id, name, company_profile_id, profile_url}, location, location_id, country_code, location_hierarchy[], classifications[]{id,label}, work_types[]{id,label}, work_arrangements[], salary{label, min, max, currency, period, hidden_by_employer}, bullet_points[], logo_url, posted_at, posted_relative, tags[], badges[], role_titles[], recruiters[]} + total + classification_counts[] + related_searches[] + location_matched[] + company_suggestion + meta.pagination

**Example request body:**
```json
{
  "company": "petronas-168551397678682"
}
```

### POST https://api.reefapi.com/jobstreet/v1/company — 1 credit
JobStreet company profile: overview, industry, size, HQ, website, specialities, mission, perks and benefits, awards, culture, gallery, logo, the employee rating breakdown (overall, 6 categories, 1-5 star counts, % recommending, salary generous/fair/poor) and the site's AI summary of reviews.

**Parameters:**
- `company` (string, required) — Company profile id (168551397678682), slug (petronas-168551397678682) or JobStreet company URL — company.company_profile_id on any job, or company-search.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]

**Returns:** company{company_profile_id, organisation_id, country, name, url, website, industry, size, primary_location, specialities[], description, mission_statement, perks_and_benefits[], awards[], culture_and_values, gallery[], logo_url, cover_url, ratings{overall, work_life_balance, ...{rating, percent, count}}, star_counts, reviews_ai_summary}

**Example request body:**
```json
{
  "company": "petronas-168551397678682"
}
```

### POST https://api.reefapi.com/jobstreet/v1/company-reviews — 1 credit
Employee reviews of a company on JobStreet, newest or most helpful first, paginated with the site's total: title, pros, cons, 1-5 ratings per category, job title, location, employment status, salary verdict, recommends, upvotes and the employer's reply.

**Parameters:**
- `company` (string, required) — Company profile id (168551397678682), slug (petronas-168551397678682) or JobStreet company URL — company.company_profile_id on any job, or company-search.
- `sort` (enum, optional, default "recent") — Review order (the two the site offers). [one of: recent, helpful]
- `page` (integer, optional, default 1) — Review page.
- `page_size` (integer, optional, default 30) — Reviews per page (site: 30).
- `location_id` (string, optional) — Only reviews from this place — a location id from location-suggest (e.g. 1000190 = Kuala Lumpur). review_locations lists where the company has reviews.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]

**Returns:** reviews[]{review_id, title, overall_rating, pros, cons, job_title, work_location, employment_status, salary_summary, recommends, ratings[]{label,value}, upvotes, created, employer_reply} + total + rating + meta.pagination

**Example request body:**
```json
{
  "company": "petronas-168551397678682"
}
```

### POST https://api.reefapi.com/jobstreet/v1/company-salaries — 2 credits
Pay ranges per role at a company as JobStreet publishes them, each next to the industry range, with the number of jobs behind each figure.

**Parameters:**
- `company` (string, required) — Company profile id (168551397678682), slug (petronas-168551397678682) or JobStreet company URL — company.company_profile_id on any job, or company-search.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]

**Returns:** roles[]{role_id, role_title, company{label,salary_type,jobs_count}, industry{label,salary_type,jobs_count,comparison}} + last_updated

**Example request body:**
```json
{
  "company": "petronas-168551397678682"
}
```

### POST https://api.reefapi.com/jobstreet/v1/company-search — 1 credit
Find JobStreet company profiles by name in one market (or page through the whole directory when name is empty): id, slug, logo, rating, review count, organisation id.

**Parameters:**
- `name` (string, optional) — Company name words. Empty = the market's company directory.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `page` (integer, optional, default 1) — Result page.
- `page_size` (integer, optional, default 30) — Companies per page.

**Returns:** companies[]{company_profile_id, slug, url, name, logo_url, rating, review_count, organisation_id} + total + meta.pagination

**Example request body:**
```json
{
  "country": "SG",
  "name": "bank"
}
```

### POST https://api.reefapi.com/jobstreet/v1/featured-companies — 1 credit
The employers JobStreet features on its company pages for a market, with rating, review count and open job count.

**Parameters:**
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `limit` (integer, optional, default 30) — How many (the site returns at most 30).

**Returns:** companies[]{company_profile_id, name, slug, url, logo_url, rating, review_count, open_jobs}

### POST https://api.reefapi.com/jobstreet/v1/role — 2 credits
JobStreet career-guide page for a role in one market: typical monthly salary, salary for the whole country and for every state/region, what the job is like, tasks and duties, how to become one, job-growth figure and the ratings people in the role gave it.

**Parameters:**
- `role` (string, required) — Role id from role-search (e.g. 'software-engineer', 'nurse', 'accountant') or a career-advice/role URL.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `location_id` (string, optional) — Also return the salary for this city/suburb — a location id from location-suggest. States/regions are always included.

**Returns:** role{role_id, title, summary, typical_salary{min,max}, salary{location,min,max,median,range_low,range_high}, salary_by_region[]{location_id,location,min,max,median}, introduction, tasks_and_duties[], how_to_become, classifications[], growth, review_stats}

**Example request body:**
```json
{
  "role": "software-engineer"
}
```

### POST https://api.reefapi.com/jobstreet/v1/role-search — 1 credit
Search JobStreet's career guide for roles: typical salary range, job satisfaction, growth.

**Parameters:**
- `keywords` (string, required) — Role words, e.g. 'nurse', 'data analyst'.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `page` (integer, optional, default 1) — Result page.
- `page_size` (integer, optional, default 20) — Roles per page.

**Returns:** roles[]{role_id, title, type, typical_salary_min, typical_salary_max, job_satisfaction, growth, classifications[]} + total

**Example request body:**
```json
{
  "keywords": "developer"
}
```

### POST https://api.reefapi.com/jobstreet/v1/role-reviews — 1 credit
Reviews written by people working in a role (career guide): ratings for pay, job security, satisfaction, work-life balance, variety and career progression, plus good things and challenges.

**Parameters:**
- `role` (string, required) — Role id from role-search.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `sentiment` (enum, optional, default "all") — Filter reviews by tone. [one of: all, positive, negative]
- `page` (integer, optional, default 1) — Review page.
- `page_size` (integer, optional, default 10) — Reviews per page.

**Returns:** reviews[]{review_id, title, submitted, overall_rating, good_things, challenges, qualification, years_in_role, organisation_size, department, ratings{}} + total

**Example request body:**
```json
{
  "role": "software-engineer"
}
```

### POST https://api.reefapi.com/jobstreet/v1/location-suggest — 1 credit
JobStreet's location autocomplete for a market: place names with their numeric location id (usable as search location_id).

**Parameters:**
- `query` (string, required) — Start of a place name.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `language` (enum, optional, default "en") — Label language. 'id' (Bahasa Indonesia) only for country ID. [one of: en, id]

**Returns:** locations[]{id, name, country_code}

**Example request body:**
```json
{
  "query": "kuala"
}
```

### POST https://api.reefapi.com/jobstreet/v1/keyword-suggest — 1 credit
JobStreet's job-title / keyword autocomplete for a market.

**Parameters:**
- `query` (string, required) — Start of a job title or keyword.
- `country` (enum, optional, default "MY") — JobStreet market: MY (my.jobstreet.com), SG (sg.jobstreet.com), PH (ph.jobstreet.com) or ID (id.jobstreet.com). A JobStreet URL also works. [one of: MY, SG, PH, ID]
- `count` (integer, optional, default 10) — How many suggestions.

**Returns:** suggestions[]

**Example request body:**
```json
{
  "query": "acc"
}
```

### POST https://api.reefapi.com/jobstreet/v1/classifications — 0 credits
JobStreet's 30 job classifications and their 397 sub-classifications, with ids for the search classification / subclassification filters (English or Bahasa Indonesia names). No upstream call.

**Parameters:**
- `language` (enum, optional, default "en") — Name language. [one of: en, id]

**Returns:** classifications[]{id, name, subclassifications[]{id, name}}

### POST https://api.reefapi.com/jobstreet/v1/filters — 0 credits
Every value the search filters accept, per market: countries with currency and default salary period, job types, work arrangements, date-posted windows, salary types and sort orders. No upstream call.

**Parameters:** none

**Returns:** countries[], job_types[], work_arrangements[], date_posted[], salary_types[], sorts[]

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=jobstreet
- Human docs page: https://reefapi.com/docs/jobstreet
- Overview page: https://reefapi.com/jobstreet-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
