# useragent로 UA 가져오기

> GET https://api.yescaptcha.com/useragent는 현재 권장하는 브라우저 User-Agent를 일반 텍스트로 반환해요. hCaptcha 작업의 userAgent는 이 값만 허용해요.

Source: https://docs.yescaptcha.com/ko/api/useragent/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/useragent/

`/useragent`는 현재 권장하는 브라우저 User-Agent를 일반 텍스트로 반환해요. `clientKey`가 필요 없고 포인트도 차감되지 않아요. [hCaptcha](https://docs.yescaptcha.com/ko/tasks/hcaptcha.md) 작업의 `userAgent` 필드는 이 값만 허용해요. 대상 웹사이트에 접속할 때도 이 값을 사용하면 토큰이 더 쉽게 통과돼요.

- GET `https://api.yescaptcha.com/useragent` (글로벌 엔드포인트)
- GET `https://cn.yescaptcha.com/useragent` (중국 엔드포인트)

## 예시

```bash
curl -s https://api.yescaptcha.com/useragent
```

응답 (2026-10-15 기준 값이며, 브라우저 버전에 따라 바뀌어요):

```text
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36
```

> **참고:** 반환값은 수시로 바뀌므로 코드에 고정하지 말고, 프로그램을 시작할 때마다 한 번 가져오세요.

-   인식 결과에 `userAgent`가 포함되어 있으면, 토큰을 제출할 때 결과에 있는 값을 사용하세요.