사용자 이름 변경
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/usernameAPI 인증
AuthorizationBearer token · header필수TwexAPI 전역 인증 토큰 (Bearer Token). 헤더에 포함되어야 합니다: Authorization: Bearer <YOUR_TWEXAPI_KEY>.
요청 본문
필수application/jsoncookiestring필수사용자가 직접 승인한 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 | anyThe 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
stringany
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
anyanyany
any401X could not authenticate the account
codeinteger필수msgstring필수dataany[] | any필수속성 표시속성 숨기기
Any of:
any[]
Array of
anyanyany
any403The account is suspended or locked, or authentication or quota was denied
codeinteger필수msgstring필수dataany[] | any필수속성 표시속성 숨기기
Any of:
any[]
Array of
anyanyany
any409The username is already taken
codeinteger필수msgstring필수dataany[] | any필수속성 표시속성 숨기기
Any of:
any[]
Array of
anyanyany
any429Rate limit exceeded
codeinteger필수msgstring필수dataany[] | any필수속성 표시속성 숨기기
Any of:
any[]
Array of
anyanyany
any500X did not confirm the change, or a server error occurred
codeinteger필수msgstring필수dataany[] | any필수속성 표시속성 숨기기
Any of:
any[]
Array of
anyanyany
any⚡대화형 콘솔POST
⚡대화형 콘솔 / API 테스트POSTLive 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"
}'const response = await fetch("https://api.twexapi.io/twitter/profile/username", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"cookie": "YOUR_X_COOKIE_OR_AUTH_TOKEN",
"username": "new_handle"
})
});import requests
response = requests.post(
"https://api.twexapi.io/twitter/profile/username",
headers={
"Authorization": "Bearer YOUR_TOKEN",
"Content-Type": "application/json"
},
json={
"cookie": "YOUR_X_COOKIE_OR_AUTH_TOKEN",
"username": "new_handle"
},
)응답 예시
{
"code": 200,
"msg": "success",
"data": {
"username": "new_handle"
}
}{
"code": 400,
"msg": "Your username must be longer than 4 characters.",
"data": null
}{
"code": 401,
"msg": "X could not authenticate the account. (32)",
"data": null
}{
"code": 0,
"msg": "string",
"data": [
null
]
}{
"code": 409,
"msg": "That username has been taken. Please choose another.",
"data": null
}{
"code": 0,
"msg": "string",
"data": [
null
]
}{
"code": 0,
"msg": "string",
"data": [
null
]
}