Saramin 채용정보 API

https://oapi.saramin.co.kr/
Admin
Saramin API is an interface for developers to receive recruitment information data. If you wish to...
Tokens:18,441
Snippets:136
Trust Score:9.7
Update:4 months ago
Show doc for...
Tokens:
Raw
### Java로 채용 공고 API 호출하기

Source: https://oapi.saramin.co.kr/guide/example

Java를 사용하여 사람인 채용공고 API를 호출하는 예제입니다. access-key와 검색 키워드를 URL에 포함시켜 GET 요청을 보내고 응답을 콘솔에 출력합니다.

```java
package kr.co.saramin.oapi;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

/**
 * 사람인 채용공고 API 샘플
 */
public class Sample {

    public static void main(String[] args) {
        String accessKey = "accessKey"; // 발급받은 accessKey";

        try {
            String text = URLEncoder.encode("", "UTF-8");
            String apiURL = "https://oapi.saramin.co.kr/job-search?access-key="+accessKey+"&keyword="+ text;

            URL url = new URL(apiURL);
            HttpURLConnection con = (HttpURLConnection)url.openConnection();
            con.setRequestMethod("GET");
            con.setRequestProperty("Accept", "application/json");

            int responseCode = con.getResponseCode();
            BufferedReader br;

            if(responseCode==200) { // 정상 호출
                br = new BufferedReader(new InputStreamReader(con.getInputStream()));
            } else {  // 에러 발생
                br = new BufferedReader(new InputStreamReader(con.getErrorStream()));
            }

            String inputLine;
            StringBuffer response = new StringBuffer();
            while ((inputLine = br.readLine()) != null) {
                response.append(inputLine);
            }
            br.close();
            System.out.println(response.toString());
        } catch (Exception e) {
            System.out.println(e);
        }
    }
}
```

--------------------------------

### Sample Error Response XML

Source: https://oapi.saramin.co.kr/guide/job-search-id

An example of an error response from the API, indicating an invalid access key.

```xml
<result>
  <code>2</code>
  <message>사용 불가능한 access-key 입니다. </message>
</result>
```

--------------------------------

### 채용 공고 API - 게시일 및 페이지네이션

Source: https://oapi.saramin.co.kr/guide/job-search

특정 게시일(published) 이후의 채용 공고를 검색하고, 페이지 번호(start)와 결과 수(count)를 지정하는 예제입니다.

```HTTP
https://oapi.saramin.co.kr/job-search?access-key={KEY}&published=2019-05-28&start=2&count=100
```

--------------------------------

### API 호출 예제 (JAVA)

Source: https://oapi.saramin.co.kr/guide/info

JAVA를 사용하여 사람인 채용정보 API를 호출하는 예제입니다. API 이용 신청 및 access-key 발급 후 사용 가능합니다.

```JAVA
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class SaraminApiExample {

    public static void main(String[] args) {
        String accessKey = "YOUR_ACCESS_KEY"; // 발급받은 access-key
        String apiUrl = "http://oapi.saramin.co.kr/job-search/";

        try {
            URL url = new URL(apiUrl + "?query=개발자&fields=original-url,title,company,location,experience-level,education,job-type,salary,posting-date&limit=10");
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();

            connection.setRequestMethod("GET");
            connection.setRequestProperty("access_key", accessKey);
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setDoOutput(true);

            // 응답 읽기
            BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8));
            StringBuilder response = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            reader.close();

            System.out.println("API Response:");
            System.out.println(response.toString());

            connection.disconnect();

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
```

--------------------------------

### 채용 공고 API - 산업 코드 및 필드 선택

Source: https://oapi.saramin.co.kr/guide/job-search

특정 산업 코드(ind_cd)를 가진 공고를 검색하고, 결과에서 키워드 코드(keyword-code) 필드만 포함하도록 요청하는 예제입니다.

```HTTP
https://oapi.saramin.co.kr/job-search?access-key={KEY}&ind_cd=40101+40102&fields=keyword-code
```

--------------------------------

### 채용 공고 API - 상장 여부 검색

Source: https://oapi.saramin.co.kr/guide/job-search

유가증권(kospi) 또는 코스닥(kosdaq) 시장 상장 기업의 채용 공고를 검색하는 예제입니다. 복수 검색이 가능합니다.

```HTTP
https://oapi.saramin.co.kr/job-search?access-key={KEY}&stock=kospi+kosdaq
```

--------------------------------

### API 호출 예제 (PHP)

Source: https://oapi.saramin.co.kr/guide/info

PHP를 사용하여 사람인 채용정보 API를 호출하는 예제입니다. API 이용 신청 및 access-key 발급 후 사용 가능합니다.

```PHP
<?php

$access_key = "YOUR_ACCESS_KEY"; // 발급받은 access-key
$url = "http://oapi.saramin.co.kr/job-search/" ;

$params = array(
    "query" => "개발자",
    "fields" => "original-url,title,company,location,experience-level,education,job-type,salary,posting-date",
    "limit" => 10
);

$headers = array(
    "access_key: " . $access_key,
    "Content-Type: application/json"
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . "?" . http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    // API 응답 데이터 처리
    print_r($data);
}

curl_close($ch);

?>
```

--------------------------------

### Update API Domain and Add Access Key

Source: https://oapi.saramin.co.kr/guide/old-api-migration

Update the API domain from http://api.saramin.co.kr to https://oapi.saramin.co.kr and add the 'access-key' parameter to your URL.

```URL
https://oapi.saramin.co.kr/job-search?access-key=**발급된 키 입력**
```

--------------------------------

### PHP로 채용 공고 API 호출하기

Source: https://oapi.saramin.co.kr/guide/example

PHP를 사용하여 사람인 채용공고 API를 호출하는 예제입니다. 발급받은 access-key와 검색 키워드를 사용하여 API 요청을 구성하고 응답을 처리합니다.

```php
<?php
    // 사람인 채용공고 API 샘플
    $params = [
        'access-key' => '발급 받은 키',
        'keyword' => '',
    ];
    $url = "https://oapi.saramin.co.kr/job-search";
    $url = $url . '?' . http_build_query($params, '', '&');

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Accept' => 'application/json', 'Content-Type' => 'application/json']);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    $response = curl_exec ($ch);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close ($ch);

    if($status_code == 200) {
        $data = json_decode($response, TRUE);
        var_dump($data);
    } else {
        echo "Error 내용:".$response;
    }
?>
```

--------------------------------

### Sample Error Response JSON

Source: https://oapi.saramin.co.kr/guide/job-search-id

This JSON object represents a typical error response from the API, indicating a missing access key.

```json
{
  "code": 1,
  "message": "access-key를 입력해 주세요."
}
```

--------------------------------

### 채용 공고 API - 공채 속보 검색

Source: https://oapi.saramin.co.kr/guide/job-search

공채 속보(bbs_gb=1)로 채용 공고를 검색하는 예제입니다. API 키를 포함해야 합니다.

```HTTP
https://oapi.saramin.co.kr/job-search?access-key={KEY}&bbs_gb=1
```

--------------------------------

### 채용 공고 API 기본 URL

Source: https://oapi.saramin.co.kr/guide/job-search

채용 공고 API의 기본 요청 URI입니다. API 키와 검색어를 포함하여 사용합니다.

```HTTP
https://oapi.saramin.co.kr/job-search?access-key={KEY}&keywords=웹+퍼블리셔
```

--------------------------------

### 채용 공고 API - 게시일 검색

Source: https://oapi.saramin.co.kr/guide/job-search

특정 게시일(published)에 등록된 채용 공고를 검색하는 예제입니다.

```HTTP
https://oapi.saramin.co.kr/job-search?access-key={KEY}&published=2019-05-08
```
Tokens:
Raw