본문으로 건너뛰기
Twexapi
한국어
Esc
↑↓이동↵열기⌘J미리보기

사용자 이름 변경

cookie로 지정한 계정의 @사용자 이름(screen name)을 변경합니다. TwexAPI는 먼저 X에 새 사용자 이름을 쓸 수 있는지 확인합니다. 이미 사용 중이면 409를, X가 허용하지 않는 이름(너무 짧음, 예약어, 사용 불가 등)이면 X의 사유와 함께 400을 반환하며, 두 경우 모두 아무것도 변경하지 않습니다. 성공하면 X에 저장된 사용자 이름을 반환합니다. 표시 이름은 POST /twitter/profile로 변경하세요. TwexAPI Bearer 키와 해당 계정의 유효한 X Cookie 또는 auth_token이 필요합니다.

API 참조로 돌아가기
/Twitter Profile Actions Endpoints
POST/twitter/profile/username
API 인증
AuthorizationBearer token · header필수
TwexAPI 전역 인증 토큰 (Bearer Token). 헤더에 포함되어야 합니다: Authorization: Bearer <YOUR_TWEXAPI_KEY>.
요청 본문
필수application/json
cookiestring필수
사용자가 직접 승인한 Twitter 세션 자격 증명 또는 auth_token (BYOC — Bring Your Own Cookie). 자격 증명은 저장되지 않으며 무상태 프록시로만 실행됩니다. 자세한 내용은 [인증 및 보안 안내](/ko/authentication#write-operations--byoc-bring-your-own-cookie) 및 [쿠키 확인 방법](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie)을 참조하세요.
usernamestring필수
새 사용자 이름: 영문자, 숫자, 밑줄로 최대 15자. 앞의 @는 무시됩니다.
matches ^\s*@?[A-Za-z0-9_]{1,15}\s*$
proxystring | any
The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://app.proxy-cheap.com/r/qiMxub
속성 표시
Any of:
string
string
any
any
응답
200Username changed
codeinteger필수
msgstring필수
dataobject필수
속성 표시
usernamestring필수
The username X saved.
400Invalid username, or X will not accept it
codeinteger필수
msgstring필수
dataany[] | any필수
속성 표시
Any of:
any[]
Array of any
any
any
any
401X could not authenticate the account
codeinteger필수
msgstring필수
dataany[] | any필수
속성 표시
Any of:
any[]
Array of any
any
any
any
403The account is suspended or locked, or authentication or quota was denied
codeinteger필수
msgstring필수
dataany[] | any필수
속성 표시
Any of:
any[]
Array of any
any
any
any
409The username is already taken
codeinteger필수
msgstring필수
dataany[] | any필수
속성 표시
Any of:
any[]
Array of any
any
any
any
429Rate limit exceeded
codeinteger필수
msgstring필수
dataany[] | any필수
속성 표시
Any of:
any[]
Array of any
any
any
any
500X did not confirm the change, or a server error occurred
codeinteger필수
msgstring필수
dataany[] | any필수
속성 표시
Any of:
any[]
Array of any
any
any
any
⚡대화형 콘솔POST
⚡대화형 콘솔 / API 테스트POST
Live Console
🌐대상 서버:https://api.twexapi.io
● 프로덕션 준비 완료
✍️
쓰기 작업 인증 정보 가이드 (TwexAPI 키 + Twitter 쿠키)

1. TwexAPI 플랫폼 키 (Bearer Token): 요청 과금 및 인증을 위해 아래 "API 인증"에 입력하세요.

2. Twitter 계정 쿠키: 트윗, 좋아요, 팔로우 등 쓰기 작업을 위해 아래 요청 본문의 cookie 필드에 쿠키(예: auth_token=...; ct0=...)를 입력하세요.

🔑API 인증
📝요청 본문application/json
📡
暂无响应数据

请在「请求配置」中确认参数后,点击底部的「发送请求」按钮。

요청 예시
curl -X POST "https://api.twexapi.io/twitter/profile/username" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "cookie": "YOUR_X_COOKIE_OR_AUTH_TOKEN",
  "username": "new_handle"
}'
응답 예시
{
  "code": 200,
  "msg": "success",
  "data": {
    "username": "new_handle"
  }
}