Skip to main content
The Jobs endpoint lets you search and retrieve job listings indexed from Rocketpunch’s network of 170,000+ companies. Query by keyword to surface relevant positions across job titles, required skills, company names, and descriptions. Results are returned in a consistent paginated structure and are available in 11 languages, making it straightforward to build multilingual job boards, recommendation engines, or talent-matching tools on top of Rocketpunch data.

​
Endpoint

GET https://openapi.rocketpunch.com/api/v1/jobs

​
Request Headers

HeaderRequiredDescription
X-RP-API-KeyYesYour App Key, in the format rp_app_xxxxxxxxxxxxxxxx. Obtain this from the developer portal.

​
Query Parameters

​
keyword
string
The search term used to filter job listings. Matched against job titles, company names, required skills, and job descriptions. For example, AI, frontend, or product manager.
​
lang
string
default:"ko"
The language code for the response content. Rocketpunch supports 11 languages. Common values include ko (Korean) and en (English). The response schema is consistent across all supported languages.
​
page
integer
default:"1"
The page number to retrieve. Use in combination with per_page to paginate through large result sets. Page numbering starts at 1.
​
per_page
integer
The number of job listings to return per page. Use this to control result set size and balance between payload size and the number of requests needed to traverse results.

​
Example Request

const response = await fetch(
  "https://openapi.rocketpunch.com/api/v1/jobs?keyword=AI&lang=en",
  {
    method: "GET",
    headers: {
      "X-RP-API-Key": "rp_app_xxxxxxxxxxxxxxxx",
    },
  }
);

const data = await response.json();
console.log(data.items);

​
Response

A successful request returns HTTP 200 with a JSON body containing a paginated list of job listings under the items key. 
{
  "items": [
    {
      "id": "job_01hx9z",
      "title": "AI Research Engineer",
      "company": {
        "name": "Rocketpunch Labs",
        "handle": "rocketpunch-labs"
      },
      "location": "Seoul, South Korea",
      "work_type": "full-time",
      "posted_at": "2024-11-01T09:00:00Z"
    }
  ],
  "total": 340,
  "page": 1,
  "per_page": 20
}
The field values shown above are illustrative examples. Actual values depend on live data at query time. Some fields may be null if the posting company has not provided that information.

​
Response Fields

​
items
array
required
An array of job listing objects matching your query. May be empty if no results are found.
​
total
integer
required
The total number of job listings matching your query across all pages.
​
page
integer
required
The current page number reflected in this response.
​
per_page
integer
required
The number of results per page reflected in this response.

​
Error Responses

HTTP StatusMeaning
401 UnauthorizedYour X-RP-API-Key is missing or invalid.
429 Too Many RequestsYou have exceeded your plan’s rate limit.
500 Internal Server ErrorAn unexpected server-side error occurred. Retry with exponential backoff.
To build a multilingual job board, issue parallel requests with different lang values for the same keyword. The response schema is identical across all 11 supported languages, so you can use a single data model on your end.