> ## Documentation Index > Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 데이터 형식 마이그레이션 export const Button = ({href, children}) => { return
; };
## 소개
X API의 v2 버전 출시와 함께 새로운 데이터 응답 형식과 서로 다른 객체 및 필드를 요청하는 새로운 방식을 도입했고, 이를 통틀어 X API v2 형식이라고 부르고 있습니다.  이 일반적인 차이점 섹션에서는 Standard 및 Enterprise 사용자와 관련된 일부 변경 사항을 확인할 수 있습니다. 또한 [Standard v1.1 Native format](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview), Enterprise용 [Native Enriched format](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-tweet-object), 그리고 Enterprise용 [Activity Streams format](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#activity-object)에 대한 별도의 가이드를 제공하여 필드 매핑을 도와주고, 새로운 v2 필드를 요청하기 위해 어떤 필드와 expansions를 사용해야 하는지 설명합니다.  * [Native format에서 X API v2로 (Standard v1.1)](/ko/x-api/migrate/data-format-migration#migrating-from-standard-v1-1s-data-format-to-v2)  * [Native Enriched에서 X API v2로 (Enterprise)](/ko/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2) * [Activity Streams에서 X API v2로 (Enterprise)](/ko/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2) 또한 [시각적 데이터 형식 마이그레이션 도구](/ko/x-api/migrate/data-format-migration#visual-data-format-migration-tool)를 사용하면 [X API v1.1 데이터 형식](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview)과 [X API v2 형식](/ko/x-api/introduction) 간의 차이점을 빠르게 확인할 수 있습니다.
### 전반적인 차이점
#### 객체와 필드 요청
pre-v2 엔드포인트와 v2 사이의 가장 큰 변화 중 하나는, 새로운 버전은 기본적으로 소수의 필드만 반환하는 반면 스탠다드, 프리미엄, 엔터프라이즈 엔드포인트는 대부분의 필드를 기본적으로 제공한다는 점입니다. 새로운 버전은 [fields](/ko/x-api/fundamentals/fields)와 [expansions](/ko/x-api/fundamentals/expansions)라는 파라미터를 사용해 기본값을 넘어서는 추가 데이터를 명시적으로 요청하도록 하며, 이를 통해 필요한 데이터만 요청하고 중요하지 않은 필드는 수집하지 않을 수 있습니다.  기본 데이터 객체와 관련된 필드를 요청하면, 해당 필드들은 기본값과 함께 그 기본 데이터 객체 안에 반환됩니다. 하지만 expansions 파라미터를 사용해 확장 객체를 요청하는 경우, 보조 객체들은 새로운 includes 객체에 반환됩니다. includes 객체 안의 확장 객체는, 두 객체 모두에 포함되어 반환되는 id 필드를 사용해서 기본 객체와 매칭할 수 있습니다. 예를 들어, v2 [Post lookup](/ko/x-api/posts/lookup/introduction) 엔드포인트를 사용하면서 요청에 expansions=author\_id 파라미터를 포함하면, 기본 게시물 객체 안에서 author\_id 필드를 받게 되며, 추가로 includes 객체 안에서 게시물당 하나의 user 객체를 받게 됩니다. 각 user 객체에는 기본 id 필드가 포함되어 있으며, 이를 사용해 user 객체를 다시 게시물 객체와 매칭할 수 있습니다. 아래는 그 예시입니다: ``` { "data": [ { "author_id": "2244994945", "id": "1397568983931392004", "text": "The Twitter Developer Platform. Ooh la la! https://t.co/iGTdPXBfOv https://t.co/Ze8z8EODdg" } ], "includes": { "users": [ { "id": "2244994945", "name": "Twitter Dev", "username": "TwitterDev" } ] } } ```
#### 업데이트된 JSON 설계
특정 필드를 요청하는 방식의 변경 사항 외에도 X API v2에서는 API가 반환하는 객체(예: [게시물](/ko/x-api/fundamentals/data-dictionary#tweet) 및 [user](/ko/x-api/fundamentals/data-dictionary#user) 객체)에 대해 새로운 JSON 설계를 도입합니다. * JSON 루트 수준에서 기존 표준 엔드포인트는 Post 객체를 **statuses** 배열에 담아 반환하는 반면, X API v2는 **data** 배열에 담아 반환합니다.  * 리트윗(Retweeted) 및 인용(Quoted) "statuses"를 사용하던 대신, X API v2 JSON은 리트윗된 Tweet과 인용된 Tweet을 참조합니다. **contributors**, **user.translator\_type**와 같은 많은 레거시 및 사용 중단된 필드는 제거되고 있습니다.  * Post 객체의 **favorites**와 user 객체의 **favourites**를 모두 사용하던 것과 달리, X API v2는 `like`라는 용어만 사용합니다.  * X는 값이 없는 JSON 값(예: null)은 페이로드에 포함하지 않는 규칙을 채택하고 있습니다. Post 및 user 속성은 null이 아닌 값을 가질 때에만 포함됩니다.   
#### 새로운 v2 필드
또한 다음을 포함하는 [게시물 객체](/ko/x-api/fundamentals/data-dictionary#tweet)의 새로운 필드 집합을 도입했습니다. * [conversation\_id](/ko/x-api/fundamentals/conversation-id) 필드 * context 및 entities를 포함하는 두 개의 새로운 [annotations](/ko/x-api/fundamentals/post-annotations) 필드 * 여러 개의 새로운 [metrics](/ko/x-api/fundamentals/metrics) 필드 * 해당 게시물에 누가 답글을 달 수 있는지 보여주는 새로운 reply\_setting 필드
### 표준 v1.1 데이터 형식에서 v2로 마이그레이션하기
아직 읽지 않았다면, 먼저 [데이터 형식 마이그레이션](/ko/x-api/migrate/data-format-migration) 소개 문서를 읽어 보시기를 권장합니다. 또한 [시각적 데이터 형식 마이그레이션 도구](/ko/x-api/migrate/data-format-migration#visual-data-format-migration-tool)를 사용해 [X API v1.1 데이터 형식](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview)과 [X API v2 형식](/ko/x-api/fundamentals/data-dictionary)의 차이를 빠르게 확인해 볼 수도 있습니다. 네이티브 형식이라고도 불리는 표준 v1.1 데이터 형식은 [standard v1.1](https://developer.x.com/en/docs/twitter-api/v1) 엔드포인트에서 기본적으로 제공되는 주된 형식입니다. 프리미엄 제품을 사용 중이라면 [네이티브 enriched 데이터 형식에서 v2로 마이그레이션하기 가이드](/ko/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2)를 참조하세요. 엔터프라이즈 클라이언트는 Gnip 콘솔에서 설정된 방식에 따라 네이티브 enriched 형식 또는 activity streams를 사용 중일 수 있습니다. 
#### 표준 v1.1 vs v2 페이로드 구조
다음 표는 v1.1 형식과 비교했을 때 v2에서 수신하게 될 상위 레벨 객체와 구조를 보여줍니다. | | **v1.1 구조** | **v2 구조** | | :-------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **기본값** | \{
~~모든 Tweet 객체 필드~~,
"entities": \{
"hashtags": \[],
"symbols": \[],
"user\_mentions": \[],
"urls": \[],
"media": \[]
},
"extended\_entities": {},
"user": {},
"place": {},
"retweeted\_status/quoted\_status"
} | \{
"data": \[\{
"id",
"text",

"edit\_history\_tweet\_ids"
}]
} | | **정의된 [field 및 expansions](/ko/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions) 매개변수 포함 시** | | \{
"data": \[\{
~~Tweet 객체 필드~~,
"entities": \{
"hashtags": \[],
"cashtags": \[],
"mentions": \[],
"urls": \[],
},
"attachments": \{

"media\_keys": \[],

"poll\_ids": \[]

}
}],
"includes": \[
"tweets": \[~~Tweet 객체~~],
"users": \[~~user 객체~~],
"media": \[~~media 객체~~],
"places": \[~~place 객체~~],

"polls": \[~~poll 객체~~]
],

"matching\_rules": \[]
} | **필드 매핑** 다음 섹션에서는 각 v1.1 필드가 어떤 v2 필드에 매핑되는지, 그리고 새 필드를 수신하기 위해 어떤 v2 매개변수가 필요한지를 설명합니다.  
#### Tweet 객체
| | | | | :----------------------------- | :----------------------------------------------- | :-------------------------------------------------------------------------- | | **Twitter 1.1 형식** | **Twitter v2 형식** | **필수 v2 매개변수** | | created\_at | data.created\_at | tweet.fields=created\_at | | id | | 해당 없음 — id는 문자열입니다 | | id\_str | data.id | 기본값 | | text | data.text | 기본값 | | full\_text | | 해당 없음 — text에 전체 텍스트가 포함됩니다 | | truncated | | 해당 없음 — text에 전체 텍스트가 포함됩니다 | | display\_text\_range | | 해당 없음 — text에 전체 텍스트가 포함됩니다 | | edit\_history | data.edit\_history\_tweet\_ids | 기본값 | | edit\_controls | data.edit\_controls | tweet.fields=edit\_controls | | editable | data.edit\_controls.is\_edit\_eligible | tweet.fields=edit\_controls | | entities | data.entities | tweet.fields=entities | | entities.user\_mentions | data.entities.mentions | tweet.fields=entities | | entities.symbols | data.entities.cashtags | tweet.fields=entities | | entities.hashtags | data.entities.hashtags | tweet.fields=entities | | entities.urls | data.entities.urls | tweet.fields=entities | | entities.media | includes.media | expansions=attachments.media\_keys | | extended\_entities | data.attachments | tweet\_fields=attachments | | in\_reply\_to\_status\_id | | 해당 없음 — referenced\_tweets.id는 문자열입니다 | | in\_reply\_to\_status\_id\_str | data.referenced\_tweets.id (if type=replied\_to) | expansions=referenced\_tweets.id | | in\_reply\_to\_user\_id | | 해당 없음 — in\_reply\_to\_user\_id는 문자열입니다 | | in\_reply\_to\_user\_id\_str | data.in\_reply\_to\_user\_id | tweet.fields=in\_reply\_to\_user\_id | | in\_reply\_to\_screen\_name | includes.users..username | tweet.fields=in\_reply\_to\_user\_id\&expansions=entities.mentions.username | | user | includes.users | expansions=author\_id | | geo | data.geo.place\_id | tweet.fields=geo | | coordinates | data.geo.place\_id | expansions=geo.place\_id | | place | data.geo.place\_id | expansions=geo.place\_id | | retweeted\_status | data.referenced\_tweets.id (if type=retweeted) | expansions=referenced\_tweets.id | | is\_quoted\_status | | 지원되지 않음 | | quoted\_status\_id | | 해당 없음 — referenced\_tweets.id는 문자열입니다 | | quoted\_status\_id\_str | data.referenced\_tweets.id (if type=quoted) | expansions=referenced\_tweets.id | | quoted\_status\_permalink | | 지원되지 않음 | | quoted\_status | data.referenced\_tweets (if type=quoted) | expansions=referenced\_tweets.id | | retweet\_count | data.public\_metrics.retweet\_count | tweet.fields=public\_metrics | | favorite\_count | data.public\_metrics.like\_count | tweet.fields=public\_metrics | | favorited | | 지원되지 않음 | | retweeted | | 지원되지 않음 | | possibly\_sensitive | data.possibly\_sensitive | tweet.fields=possibly\_sensitive | | lang | data.lang | tweet.fields=lang | | scopes | | 지원되지 않음 | | withheld | data.withheld | tweet.fields=withheld | **예시** | | | | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **v1.1의 Tweet 객체**

예제 URI (매개변수 포함):

[https://api.x.com/1.1/statuses/lookup.json?id=1359554366051504129\&tweet\_mode=extended](https://api.x.com/1.1/statuses/lookup.json?id=1359554366051504129\&tweet\_mode=extended) | **Tweet 객체 및 v2 요청**

매개변수 포함 예시 URI:

[https://api.x.com/2/tweets?ids=1359554366051504129\&tweet.fields=attachments,author\_id,context\_annotations,conversation\_id,created\_at,entities,geo,id,in\_reply\_to\_user\_id,lang,possibly\_sensitive,public\_metrics,referenced\_tweets,reply\_settings,text,withheld](https://api.x.com/2/tweets?ids=1359554366051504129\&tweet.fields=attachments,author\_id,context\_annotations,conversation\_id,created\_at,entities,geo,id,in\_reply\_to\_user\_id,lang,possibly\_sensitive,public\_metrics,referenced\_tweets,reply\_settings,text,withheld) | | \{
"created\_at": "Wed Feb 10 17:26:34 +0000 2021",
"id": 1359554366051504129,
"id\_str": "1359554366051504129",
"text": "마음껏 강아지 계정을 하나 더 팔로우하세요. 우리는 평가하지 않을게요. \n\n새로운 …에 대한 manage follows 엔드포인트를 소개합니다 [https://t.co/3cBZKZUevF](https://t.co/3cBZKZUevF)",
"truncated": true,
"entities": \{
"hashtags": \[],
"symbols": \[],
"user\_mentions": \[],
"urls": \[\{
"url": "[https://t.co/3cBZKZUevF](https://t.co/3cBZKZUevF)",
"expanded\_url": "[https://twitter.com/i/web/status/1359554366051504129](https://twitter.com/i/web/status/1359554366051504129)",
"display\_url": "twitter.com/i/web/status/1…",
"indices": \[
111,
134
]
}]
},

"in\_reply\_to\_status\_id": null,
"in\_reply\_to\_status\_id\_str": null,
"in\_reply\_to\_user\_id": null,
"in\_reply\_to\_user\_id\_str": null,
"in\_reply\_to\_screen\_name": null,
"user": \{
...
},
"geo": null,
"coordinates": null,
"place": null,
"contributors": null,
"is\_quote\_status": false,
"retweet\_count": 18,
"favorite\_count": 98,
"favorited": false,
"retweeted": false,
"possibly\_sensitive": false,
"possibly\_sensitive\_appealable": false,
"lang": "en"
} | \{
"data": \[\{
"id":"1359554366051504129",
"텍스트":"다른 강아지 계정을 팔로우해도 괜찮습니다. 우리는 판단하지 않습니다. \n\n새로운 #TwitterAPI에 팔로우 관리 엔드포인트를 소개합니다. 이제 v2 API를 사용하여 계정을 팔로우하고 언팔로우할 수 있습니다. 자세히 알아보기 [https://t.co/mtpd9VIMDa](https://t.co/mtpd9VIMDa)",
"lang":"en",
"conversation\_id":"1359554366051504129",
"possibly\_sensitive": false,
"답글\_설정":"everyone",
"생성일\_at":"2021-02-10T17:26:34.000Z",
"author\_id":"2244994945",
"public\_메트릭":\{
"retweet\_count": 18,
"답글\_count": 11,
"like\_count": 98,
"인용 트윗\_count": 7
},
"entities":\{
"hashtags": \[\{
"시작": 110,
"end": 121,
"태그":"TwitterAPI"
}],
"urls": \[\{
"시작": 194,
"end": 217,
"url":"[https://t.co/mtpd9VIMDa](https://t.co/mtpd9VIMDa)",
"확장된\_url":"[https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465](https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465)",
"display\_url":"devcommunity.com/t/introducing-…",
"images": \[\{
"url":"[https://pbs.twimg.com/news\_img/1359554367905427457/DczC72\_\_?format=jpg\&name=orig](https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg\&name=orig)",
"width": 1200,
"height": 630
},
\{
"url":"[https://pbs.twimg.com/news\_img/1359554367905427457/DczC72\_\_?format=jpg\&name=150x150](https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg\&name=150x150)",
"width": 150,
"height": 150
}
],
"status": 200,
"title":"X API v2의 새로운 팔로우 관리 엔드포인트 소개",
"설명":"팔로우할까, 말까? 이제 X API v2를 사용하여 원하는 대로 이 질문에 답할 수 있습니다. 오늘 새로운 팔로우 관리 엔드포인트가 새로운 Twitter API에 출시되었음을 발표하게 되어 기쁩니다. 한 달 조금 전에 팔로우 조회 엔드포인트를 출시하면서 예고했듯이, 팔로우 관계를 관리하는 기능이 드디어 제공됩니다. 이는 v1.1 API에서 가장 인기 있는 엔드포인트 중 일부이므로, X API v2에서 다양한 사용 사례를 지원하게 되어 기쁩니다. W\...",
"unwound\_url":"[https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465](https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465)"
}]
},
"context\_어노테이션": \[\{
"domain":\{
"id":"46",
"name":"브랜드 카테고리",
"설명":"브랜드 버티컬 내에서 브랜드 범위를 세분화하는 카테고리"
},
"entity":\{
"id":"781974596752842752",
"name":"서비스"
}
},
\{
"domain":\{
"id":"47",
"name":"브랜드",
"설명":"브랜드 및 회사"
},
"entity":\{
"id":"10045225402",
"name":"Twitter"
}
}
]
}]
} | ***
#### User 객체
| | | | | :----------------------------------------------- | :---------------------------------------------- | :----------------------------------------------------- | | **Twitter 1.1 형식** | **Twitter v2 형식** | **필수 v2 매개변수** | | user\_id | data.author\_id | tweet.fields=author\_id | | user.id | | N/A - includes.users.id 사용 | | user.id\_str | includes.users.id | expansions=author\_id | | user.name | includes.users.name | expansions=author\_id | | user.screen\_name | includes.user.username | expansions=author\_id | | user.location | includes.users.location | expansions=author\_id\&user.fields=location | | user.description | includes.users.description | expansions=author\_id\&user.fields=description | | user.url | includes.users.url | expansions=author\_id\&user.fields=entities | | user.entities | includes.users.entities | | | user.entities.url.urls.url | includes.users.entities.url.urls.url | | | user.entities.url.urls.expanded\_url | includes.users.entities.url.urls.expanded\_url | expansions=author\_id\&user.fields=entities | | user.entities.url.urls.display\_url | includes.users.entities.url.urls.display\_url | expansions=author\_id\&user.fields=entities | | user.entities.url.urls.display\_url.indicies\[0] | includes.users.entities.url.urls.start | expansions=author\_id\&user.fields=entities | | user.entities.url.urls.display\_url.indicies\[1] | includes.users.entities.url.urls.end | expansions=author\_id\&user.fields=entities | | user.protected | includes.users.protected | expansions=author\_id\&user.fields=protected | | user.followers\_count | includes.users.public\_metrics.followers\_count | expansions=author\_id\&user.fields=public\_metrics | | user.friends\_count | includes.users.public\_metrics.following\_count | expansions=author\_id\&user.fields=public\_metrics | | user.listed\_count | includes.users.public\_metrics.listed\_count | expansions=author\_id\&user.fields=public\_metrics | | user.created\_at | includes.users.created\_at | expansions=author\_id\&user.fields=created\_at | | user.favourites\_count | | | | user.verified | includes.users.verified | expansions=author\_id\&user.fields=verified | | user.statuses\_count | includes.users.public\_metrics.tweet\_count | expansions=author\_id\&user.fields=public\_metrics | | user.profile\_image\_url\_https | includes.users.profile\_image\_url | expansions=author\_id\&user.fields=profile\_image\_url | **예시** | | | | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **v1.1의 사용자 객체** | **v2에서의 User 객체 및 요청 방법** | | "user":\{
"id": 2244994945,
"id\_str":"2244994945",
"name":"Twitter Dev",
"화면\_name":"TwitterDev",
"location":"127.0.0.1",
"description":"#TwitterDev 팀의 목소리이자 #TwitterAPI 관련 업데이트, 뉴스 및 이벤트에 대한 공식 소스입니다.",
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"entities":\{
"url":\{
"urls": \[\{
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"확장된\_url":"[https://developer.x.com/ko/community](https://developer.x.com/ko/community)",
"display\_url":"developer.x.com/ko/community",
"indices": \[
0,
23
]
}]
},
"description":\{
"urls": \[]
}
},
"protected": false,
"팔로워\_count": 517232,
"친구들\_count": 2032,
"리스트 등록됨\_count": 1722,
"생성일\_at":"Sat Dec 14 04:35:55 +0000 2013",
"favourites\_count": 2134,
"utc\_offset": null,
"time\_zone": null,
"geo\_enabled": true,
"verified": true,
"statuses\_count": 3677,
"lang": null,
"기여자\_enabled": false,
"이\_번역기": false,
"이\_번역\_enabled": false,
"profile\_배경\_color":"FFFFFF",
"profile\_배경\_이미지\_url":"[http://abs.twimg.com/images/themes/theme1/bg.png](http://abs.twimg.com/images/themes/theme1/bg.png)",
"profile\_배경\_이미지\_url\_https":"[https://abs.twimg.com/images/themes/theme1/bg.png](https://abs.twimg.com/images/themes/theme1/bg.png)",
"profile\_배경\_타일": false,
"profile\_이미지\_url":"[http://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg](http://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg)",
"profile\_이미지\_url\_https":"[https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg](https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg)",
"profile\_banner\_url":"[https://pbs.twimg.com/profile\_banners/2244994945/1611792896](https://pbs.twimg.com/profile\_banners/2244994945/1611792896)",
"profile\_링크\_color":"0084B4",
"profile\_sidebar\_border\_color":"FFFFFF",
"profile\_sidebar\_fill\_color":"DDEEF6",
"profile\_텍스트\_color":"333333",
"profile\_사용\_배경\_이미지": false,
"has\_extended\_profile": true,
"기본값\_profile": false,
"기본값\_profile\_이미지": false,
"following": null,
"follow\_요청\_발송됨": null,
"notifications": null,
"번역기\_type":"regular"
} | \{
"data": \[\{
"author\_id": "2244994945",
"id": "1362876655061073928",
"text": "우리 거실에서 여러분의 거실까지 🐱‍💻🛋️ 우리 개발자 옹호 담당자들이 새로운 #TwitterAPI를 시작하는 데 도움이 될 흥미로운 Twitch 스트림과 온라인 이벤트를 준비해 두었습니다. 자세한 내용은 일정을 확인하시고, 더 보고 싶으신 것이 있다면 알려 주세요!\n👇\nhttps\://t.co/cixDY9qkvH"
}],
"includes": \{
"users": \[\{
"public\_metrics": \{
"followers\_count": 517233,
"following\_count": 2034,
"tweet\_count": 3677,
"listed\_count": 1727
},
"username": "TwitterDev",
"entities": \{
"url": \{
"urls": \[\{
"start": 0,
"end": 23,
"url": "[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"expanded\_url": "[https://developer.x.com/en/community](https://developer.x.com/en/community)",
"display\_url": "developer.x.com/en/community"
}]
},
"description": \{
"hashtags": \[\{
"start": 17,
"end": 28,
"tag": "TwitterDev"
},
\{
"start": 105,
"end": 116,
"tag": "TwitterAPI"
}
]
}
},
"description": "#TwitterDev 팀의 목소리이자 #TwitterAPI 관련 업데이트, 뉴스 및 이벤트에 대한 공식 정보 출처입니다.",
"name": "Twitter Dev",
"verified": true,
"location": "127.0.0.1",
"id": "2244994945",
"protected": false,
"url": "[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"profile\_image\_url": "[https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg](https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg)",
"created\_at": "2013-12-14T04:35:55.000Z"
}]
}
} | #### 엔티티 및 확장 엔티티 객체 | | | | | | :---------------------------------------------------- | :--------------------------------- | :------------------------------------------------------------------- | :--------------- | | **Twitter 1.1 format** | **Twitter v2 format** | **Required v2 parameters** | **Type in v2** | | entities | data.entities | tweet.fields=entities | object | | entities.hashtags | data.entities.hashtags | tweet.fields=entities | array of objects | | entities.hashtags.indices\[0] | data.entities.hashtags.start | tweet.fields=entities | number | | entities.hashtags.indices\[1] | data.entities.hashtags.end | tweet.fields=entities | number | | entities.hashtags.text | data.entities.hashtags.tag | tweet.fields=entities | string | | entities.urls | data.entities.urls | tweet.fields=entities | array of objects | | entities.urls.indices\[0] | data.entities.urls.start | tweet.fields=entities | number | | entities.urls.indices\[1] | data.entities.urls.end | tweet.fields=entities | number | | entities.urls.url | data.entities.urls.url | tweet.fields=entities | string | | entities.user\_mentions | data.entities.mentions | tweet.fields=entities | array of objects | | entities.user\_mentions.indicies\[0] | data.entities.mentions.start | tweet.fields=entities | number | | entities.user\_mentions.indicies\[1] | data.entities.mentions.end | tweet.fields=entities | number | | entities.user\_mentions.screen\_name | data.entities.mentions.username | tweet.fields=entities | string | | entities.symbols | data.entities.cashtags | tweet.fields=entities | array of objects | | entities.symbols.indices\[0] | data.entities.cashtags.start | tweet.fields=entities | number | | entities.symbols.indices\[1] | data.entities.cashtags.end | tweet.fields=entities | number | | entities.symbols.text | data.entities.cashtags.tag | tweet.fields=entities | string | | entities.media | includes.media | expansions=attachments.media\_keys | array of objects | | entities.media.id\_str | includes.media.media\_key | expansions=attachments.media\_keys | string | | entities.media.type | includes.media.media.type | expansions=attachments.media\_keys | string | | entities.media.media\_url | | 해당 없음. includes.media.url 사용 | string | | entities.media.media\_url\_https | includes.media.url | expansions=attachments.media\_keys\&media.fields=url | string | | entities.media.url | | | | | entities.media.display\_url | | | | | entities.media.expanded\_url | | | | | entities.media.media\_url\_https | includes.media.preview\_image\_url | expansions=attachments.media\_keys\&media.fields=preview\_image\_url | string | | extended\_entities | data.attachments | tweet\_fields=attachments | object | | extended\_entities | data.attachments.media\_keys | tweet.fields=attachments | array of objects | | extended\_entities.media | includes.media | expansions=attachments.media\_keys | array of objects | | extended\_entities.media.id\_str | includes.media.media\_key | expansions=attachments.media\_keys | string | | extended\_entities.media.type | includes.media.media.type | expansions=attachments.media\_keys | string | | extended\_entities.media.sizes.thumb.w | | 지원되지 않음 | | | extended\_entities.media.sizes.thumb.h | | 지원되지 않음 | | | extended\_entities.media.sizes.thumb.resize | | 지원되지 않음 | | | extended\_entities.media.sizes.large.w | includes.media.height | expansions=attachments.media\_keys\&media.fields=height | | | extended\_entities.media.sizes.large.h | includes.media.width | expansions=attachments.media\_keys\&media.fields=width | | | extended\_entities.media.sizes.large.resize | | 지원되지 않음 | | | extended\_entities.media.sizes.small.w | | 지원되지 않음 | | | extended\_entities.media.sizes.small.h | | 지원되지 않음 | | | extended\_entities.media.sizes.small.resize | | 지원되지 않음 | | | extended\_entities.media.sizes.medium.w | | 지원되지 않음 | | | extended\_entities.media.sizes.medium.h | | 지원되지 않음 | | | extended\_entities.media.sizes.medium.resize | | 지원되지 않음 | | | extended\_entities.media.media\_url\_https | includes.media.url | expansions=attachments.media\_keys\&media.fields=url | string | | extended\_entities.media.media\_url\_https | includes.media.preview\_image\_url | expansions=attachments.media\_keys\&media.fields=preview\_image\_url | string | | extended\_entities.media.video\_info.duration\_millis | includes.media.duration\_ms | expansions=attachments.media\_keys\&media.fields=duration\_ms | number | **예시** | | | | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **v1.1의 엔티티 및 확장 엔티티 (비디오 포함)** | **v2의 entities, attachments 및 includes**

[https://api.x.com/2/tweets?ids=1370161532013735937\&expansions=attachments.media\_keys,entities.mentions.username\&tweet.fields=entities\&user.fields=created\_at,description,entities,location,name,profile\_image\_url,protected,public\_metrics,url,username,verified,withheld\&media.fields=duration\_ms,height,media\_key,preview\_image\_url,public\_metrics,type,url,width](https://api.x.com/2/tweets?ids=1370161532013735937\&expansions=attachments.media\_keys,entities.mentions.username\&tweet.fields=entities\&user.fields=created\_at,description,entities,location,name,profile\_image\_url,protected,public\_metrics,url,username,verified,withheld\&media.fields=duration\_ms,height,media\_key,preview\_image\_url,public\_metrics,type,url,width) | | "entities":\{
"hashtags": \[\{
"text":"test",
"indices": \[
8,
13
]
}],
"symbols": \[],
"user\_mentions": \[\{
"화면\_name":"TwitterDev",
"name":"Twitter Dev",
"id": 2244994945,
"id\_str":"2244994945",
"indices": \[
31,
42
]
}],
"urls": \[\{
"url":"[https://t.co/XVLZ3uwikc](https://t.co/XVLZ3uwikc)",
"확장됨\_url":"[https://developer.x.com/en](https://developer.x.com/en)",
"display\_url":"developer.x.com/en",
"indices": \[
91,
114
]
}],
"media": \[\{
"id": 1370161464028196868,
"id\_str":"1370161464028196868",
"indices": \[
115,
138
],
"media\_url":"[http://pbs.twimg.com/ext\_tw\_video\_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg](http://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg)",
"media\_url\_https":"[https://pbs.twimg.com/ext\_tw\_video\_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg](https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg)",
"url":"[https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"display\_url":"pic.x.com/dz4oByygWA",
"expanded\_url":"[https://twitter.com/furiouscamper/status/1370161532013735937/video/1](https://twitter.com/furiouscamper/status/1370161532013735937/video/1)",
"type":"photo",
"sizes":\{
"thumb":\{
"w": 150,
"h": 150,
"resize":"crop"
},
"small":\{
"w": 383,
"h": 680,
"resize":"fit"
},
"large":\{
"w": 720,
"h": 1280,
"resize":"fit"
},
"medium":\{
"w": 675,
"h": 1200,
"resize":"fit"
}
}
}]
},
"extended\_entities":\{
"media": \[\{
"id": 1370161464028196868,
"id\_str":"1370161464028196868",
"indices": \[
115,
138
],
"media\_url":"[http://pbs.twimg.com/ext\_tw\_video\_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg](http://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg)",
"media\_url\_https":"[https://pbs.twimg.com/ext\_tw\_video\_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg](https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg)",
"url":"[https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"display\_url":"pic.x.com/dz4oByygWA",
"확장\_url":"[https://twitter.com/furiouscamper/status/1370161532013735937/video/1](https://twitter.com/furiouscamper/status/1370161532013735937/video/1)",
"type":"video",
"sizes":\{
"thumb":\{
"w": 150,
"h": 150,
"resize":"crop"
},
"small":\{
"w": 383,
"h": 680,
"resize":"fit"
},
"large":\{
"w": 720,
"h": 1280,
"resize":"fit"
},
"medium":\{
"w": 675,
"h": 1200,
"resize":"fit"
}
},
"video\_참고":\{
"가로세로 비율\_비율": \[
9,
16
],
"duration\_밀리초": 5140,
"variants": \[\{
"비트레이트": 950000,
"내용\_type":"video/mp4",
"url":"[https://video.twimg.com/ext\_tw\_video/1370161464028196868/pu/vid/480x852/rAuFVMEqs0MeP4P4.mp4?tag=12](https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/480x852/rAuFVMEqs0MeP4P4.mp4?tag=12)"
},
\{
"비트레이트": 2176000,
"content\_type":"video/mp4",
"url":"[https://video.twimg.com/ext\_tw\_video/1370161464028196868/pu/vid/720x1280/ZxVL5qYO-DNVuSyq.mp4?tag=12](https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/720x1280/ZxVL5qYO-DNVuSyq.mp4?tag=12)"
},
\{
"content\_type":"application/x-mpegURL",
"url":"[https://video.twimg.com/ext\_tw\_video/1370161464028196868/pu/pl/EGVpuZpo-wYxTNCq.m3u8?tag=12](https://video.twimg.com/ext_tw_video/1370161464028196868/pu/pl/EGVpuZpo-wYxTNCq.m3u8?tag=12)"
},
\{
"비트레이트": 632000,
"content\_type":"video/mp4",
"url":"[https://video.twimg.com/ext\_tw\_video/1370161464028196868/pu/vid/320x568/M7VtocAwKPFdkqzF.mp4?tag=12](https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/320x568/M7VtocAwKPFdkqzF.mp4?tag=12)"
}
]
},
"추가적인\_media\_참고":\{
"수익화 가능 여부": false
}
}]
} | \{
"data": \[\{
"entities":\{
"hashtags": \[\{
"start": 8,
"end": 13,
"태그":"test"
}],
"mentions": \[\{
"start": 31,
"end": 42,
"username":"TwitterDev"
}],
"urls": \[\{
"start": 91,
"end": 114,
"url":"[https://t.co/XVLZ3uwikc](https://t.co/XVLZ3uwikc)",
"확장됨\_url":"[https://developer.x.com/en](https://developer.x.com/en)",
"display\_url":"developer.x.com/ko",
"status": 200,
"title":"사용 사례, 튜토리얼,&문서화",
"설명":"게시하기\&Tweet 분석, 광고 최적화,\&Twitter API, Twitter Ads API를 사용하여 고유한 고객 경험을 만들고,\&Twitter for Websites. Let'구축을 시작하세요.",
"전개된\_url":"[https://developer.x.com/en](https://developer.x.com/en)"
},
\{
"start": 115,
"종료": 138,
"url":"[https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"확장됨\_url":"[https://x.com/furiouscamper/status/1370161532013735937/video/1](https://x.com/furiouscamper/status/1370161532013735937/video/1)",
"display\_url":"pic.x.com/dz4oByygWA"
}
]
},
"id":"1370161532013735937",
"텍스트":"비디오와 @TwitterDev 멘션이 포함된 또 다른 #test입니다. 새로운 형식 마이그레이션 문서가 기대됩니다! [https://t.co/XVLZ3uwikc](https://t.co/XVLZ3uwikc) [https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"attachments":\{
"media\_키(keys)": \[
"7\_1370161464028196868"
]
}
}],
"includes":\{
"media": \[\{
"type":"video",
"height": 1280,
"public\_metrics":\{
"보기\_count": 37
},
"width": 720,
"media\_key":"7\_1370161464028196868",
"duration\_ms": 5140,
"미리보기\_image\_url":"[https://pbs.twimg.com/ext\_tw\_video\_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg](https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg)"
}],
"users": \[\{
"public\_metrics":\{
"팔로워\_count": 517233,
"팔로우\_count": 2034,
"tweet\_count": 3677,
"리스트에 등록됨\_count": 1727
},
"생성일\_at":"2013-12-14T04:35:55.000Z",
"프로필\_image\_url":"[https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg](https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg)",
"설명":"#TwitterDev 팀의 목소리이자 #TwitterAPI 관련 업데이트, 뉴스 및 이벤트에 대한 공식 소스입니다.",
"verified": true,
"id":"2244994945",
"username":"TwitterDev",
"protected": false,
"entities":\{
"url":\{
"urls": \[\{
"시작": 0,
"end": 23,
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"확장됨\_url":"[https://developer.x.com/en/community](https://developer.x.com/en/community)",
"display\_url":"developer.x.com/en/community"
}]
},
"설명":\{
"hashtags": \[\{
"시작": 17,
"end": 28,
"태그":"TwitterDev"
},
\{
"시작": 105,
"끝": 116,
"태그":"TwitterAPI"
}
]
}
},
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"name":"Twitter Dev",
"location":"127.0.0.1"
}]
}
} | *** #### 장소 객체 | | | | | :--------------------------------- | :-------------------------------- | :------------------------------------------------------- | | **Twitter 1.1 형식** | **Twitter v2 형식** | **필수 v2 파라미터** | | place | data.geo.place\_id | tweet.fields=geo | | place.id | includes.places.id | expansions=geo.place\_id | | place.id.place\_type | includes.places.place\_type | expansions=geo.place\_id\&place.fields=place\_type | | place.id.name | includes.places.name | expansions=geo.place\_id\&place.fields=name | | place.id.full\_name | includes.places.full\_name | expansions=geo.place\_id | | place.id.country\_code | includes.places.country\_code | expansions=geo.place\_id\&place.fields=country\_code | | place.id.country | includes.places.country | expansions=geo.place\_id\&place.fields=country | | place.id.contained\_within | includes.places.contained\_within | expansions=geo.place\_id\&place.fields=contained\_within | | place.id.bounding\_box.type | includes.places.geo.type | expansions=geo.place\_id\&place.fields=place\_type | | place.id.bounding\_box.coordinates | includes.places.geo.bbox | expansions=geo.place\_id\&place.fields=geo | | place.id.attributes | includes.places.properties | expansions=geo.place\_id\&place.fields=geo | **예시** | | | | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **v1.1의 Place 객체** | **v2의 Place 객체**

[https://api.x.com/2/tweets?ids=1370161532013735937\&expansions=geo.place\_id\&tweet.fields=geo\&place.fields=contained\_within,country,country\_code,full\_name,geo,id,name,place\_type](https://api.x.com/2/tweets?ids=1370161532013735937\&expansions=geo.place\_id\&tweet.fields=geo\&place.fields=contained\_within,country,country\_code,full\_name,geo,id,name,place\_type) | | "place": \{
"id": "f7eb2fa2fea288b1",
"url": "[https://api.x.com/1.1/geo/id/f7eb2fa2fea288b1.json](https://api.x.com/1.1/geo/id/f7eb2fa2fea288b1.json)",
"place\_type": "city",
"name": "Lakewood",
"full\_name": "Lakewood, CO",
"country\_code": "US",
"country": "United States",
"contained\_within": \[],
"bounding\_box": \{
"type": "Polygon",
"coordinates": \[
\[
\[
-105.193475,
39.60973
],
\[
-105.053164,
39.60973
],
\[
-105.053164,
39.761974
],
\[
-105.193475,
39.761974
]
]
]
},
"attributes": {}
} | \{
"data": \[\{
"id": "1370161532013735937",
"text": "Another #test with a video and @TwitterDev mention. Excited for new format migration docs! [https://t.co/XVLZ3uwikc](https://t.co/XVLZ3uwikc) [https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"geo": \{
"place\_id": "f7eb2fa2fea288b1"
}
}],
"includes": \{
"places": \[\{
"name": "Lakewood",
"place\_type": "city",
"full\_name": "Lakewood, CO",
"id": "f7eb2fa2fea288b1",
"geo": \{
"type": "Feature",
"bbox": \[
-105.193475,
39.60973,
-105.053164,
39.761974
],
"properties": {}
},
"country\_code": "US",
"country": "United States"
}]
} | **다음 단계** * [필드](/ko/x-api/fundamentals/fields)에 대해 자세히 알아보기 * [expansions](/ko/x-api/fundamentals/expansions)에 대해 자세히 알아보기 * [필드와 expansions를 함께 사용하는 방법](/ko/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions)에 대해 자세히 알아보기
### Native Enriched 데이터 포맷에서 v2로 마이그레이션
Native Enriched 데이터 포맷은 당사의 [enterprise](/ko/x-api/enterprise-gnip-2.0/enterprise-gnip) 제품에서 사용됩니다. Native Enriched 데이터 포맷은 편집된 Tweet 메타데이터를 제공하도록 업데이트되었습니다. Edit Tweet 메타데이터에 대해 더 알아보려면 [Edit Tweets fundamentals](/ko/x-api/enterprise-gnip-2.0/fundamentals/edit-tweets) 페이지를 참조하세요. 표준 v1.1 엔드포인트를 사용 중이라면 [standard v1.1 to v2 guide](/ko/x-api/migrate/data-format-migration#migrating-from-standard-v1-1s-data-format-to-v2)를 참조하세요. Activity Streams를 사용하는 enterprise 제품을 사용 중이라면 [Activity Streams to v2](/ko/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2) 가이드도 준비되어 있습니다. X API v2는 [Tweet](/ko/x-api/fundamentals/data-dictionary#tweet) 및 [user](/ko/x-api/fundamentals/data-dictionary#user) 객체에 대해 새로운 JSON 설계를 도입했습니다. * JSON 루트 레벨에서 Native Enriched 포맷은 Tweet 객체를 results 배열로 반환하는 반면, X API v2는 data 배열로 반환합니다.  * Tweet 객체의 favorites와 user 객체의 favourites를 모두 사용하는 대신, X API v2는 like라는 용어만 사용합니다.  * X는 값이 없는 JSON 값(예: null)은 payload에 기록하지 않는 규칙을 채택하고 있습니다. Tweet 및 user 속성은 null이 아닌 값을 가질 때만 포함됩니다.  * v2의 모든 id 필드는 문자열(string) 형식입니다.   새 JSON 포맷 변경 사항 외에도, Tweet 객체에 다음을 포함한 새로운 필드 세트도 도입했습니다: * conversation\_id * reply\_settings * 미디어의 alt\_text * context 및 entities를 포함한 두 개의 새로운 [annotations](/ko/x-api/fundamentals/post-annotations) 필드 * 여러 개의 새로운 [metrics](/ko/x-api/fundamentals/metrics) 필드 * 여러 개의 새로운 [polls](/ko/x-api/fundamentals/data-dictionary#poll) 필드   많은 레거시 및 사용 중단(deprecated) 필드가 제거됩니다: * contributors * 특정 entities.media 및 extended\_entities.media 필드 * filter\_level * timestamp\_ms * truncated
#### Native Enriched vs v2 페이로드 구조
다음 표는 Native Enriched 포맷과 비교했을 때 v2에서 받게 될 상위 수준 객체와 형식을 보여 줍니다. | | **Native Enriched 구조** | **v2 구조** | | :----------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **기본값** | \{
~~tweet object fields~~,

"user": {},
"place": {},
"entities": \{
"hashtags": \[],
"urls": \[],
"user\_mentions": \[],
"symbols": \[],
"annotations": \[],
"media": \[]
},
"extended\_entities": {},
"matching\_rules": \[]
} | \{
"data": \[\{
"id",
"text",

"edit\_history\_tweet\_ids"
}]
} | | **정의된 [field and expansion](/ko/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions) 매개변수가 있는 경우** | | \{
"data": \[\{
~~tweet object fields~~,
"entities": \{
"hashtags": \[],
"cashtags": \[],
"mentions": \[],
"urls": \[],
},
"attachments": \{
"media\_keys": \[],
"poll\_ids": \[]
}
}],
"includes": \[
"tweets": \[~~user objects~~],
"users": \[~~user objects~~],
"media": \[~~media objects~~],
"places": \[~~place object~~],
"polls": \[~~poll object~~]
],
"matching\_rules": \[]
} | **필드 매핑** 다음 섹션에서는 어떤 Native Enriched 필드가 어떤 v2 필드에 매핑되는지와, 새 필드를 받기 위해 필요한 v2 매개변수가 무엇인지 설명합니다.  
#### Tweet 객체
| | | | | | :-------------------------------------------------------- | :------------------------------------------------- | :-------------------------------------------------------------------------- | :------------- | | **Native Enriched 형식** | **Twitter v2 형식** | **필수 v2 파라미터** | **v2에서의 type** | | created\_at | data.created\_at | tweet.fields=created\_at | 문자열 | | id | | 해당 없음 - id를 참조 | | | id\_str | data.id | 기본값 | 문자열 | | text | data.text | 기본값 | 문자열 | | edit\_history | data.edit\_history\_tweet\_ids | 기본값 | 배열 | | edit\_controls | data.edit\_controls | tweet.fields=edit\_controls | 객체 | | editable | data.edit\_controls.is\_edit\_eligible | tweet.fields=edit\_controls | 불리언 | | display\_text\_range | | 해당 없음 - 전체 텍스트가 text에 포함됨 | | | source | data.source | tweet.fields=source | 문자열 | | truncated | | 해당 없음 - 전체 텍스트가 text에 포함됨 | | | 지원되지 않음 | data.conversation\_id | tweet.fields=conversation\_id | 문자열 | | 지원되지 않음 | data.reply\_settings | tweet.fields=reply\_settings | String | | in\_reply\_to\_status\_id | | 해당 없음 - referenced\_tweets.id를 참조하세요 | | | in\_reply\_to\_status\_id\_str | data.referenced\_tweets.id (type=replied\_to 인 경우) | expansions=referenced\_tweets.id | String | | in\_reply\_to\_user\_id | | 해당 없음 - in\_reply\_to\_user\_id\_str를 참조하세요 | | | in\_reply\_to\_user\_id\_str | data.in\_reply\_to\_user\_id | tweet.fields=in\_reply\_to\_user\_id | String | | in\_reply\_to\_screen\_name | includes.users..username | tweet.fields=in\_reply\_to\_user\_id\&expansions=entities.mentions.username | String | | user | includes.users | expansions=author\_id | Object | | user.id\_str | data.author\_id | tweet.fields=author\_id | String | | geo | data.geo.place\_id | tweet.fields=geo | | | coordinates | data.geo.place\_id | tweet.fields=geo | | | place | data.geo.place\_id | tweet.fields=geo | | | is\_quoted\_status | data.referenced\_tweets.id (type=quoted 인 경우) | tweet.fields=referenced\_tweets | String | | extended\_tweet.full\_text | | 해당 없음 - text에는 전체 텍스트가 포함됩니다 | | | 해당 없음 | data.public\_metrics | tweet.fields=public\_metrics | 객체(Object) | | quote\_count | data.public\_metrics.quote\_count | tweet.fields=public\_metrics | 정수(Int) | | reply\_count | data.public\_metrics.reply\_count | tweet.fields=public\_metrics | 정수(Int) | | retweet\_count | data.public\_metrics.retweet\_count | tweet.fields=public\_metrics | 정수(Int) | | favorite\_count | data.public\_metrics.like\_count | tweet.fields=public\_metrics | 정수(Int) | | 해당 없음 | data.non\_public\_metrics | tweet.fields=non\_public\_metrics | 객체(Object) | | 해당 없음 | data.non\_public\_metrics.impression\_count | tweet.fields=non\_public\_metrics | 정수(Int) | | 해당 없음 | data.non\_public\_metrics.url\_link\_count | tweet.fields=non\_public\_metrics | 정수(Int) | | 해당 없음 | data.non\_public\_metrics.user\_profile\_count | tweet.fields=non\_public\_metrics | 정수(Int) | | 해당 없음 | data.organic\_metrics | tweet.fields=organic\_metrics | 객체 | | 제공되지 않음 | data.organic\_metrics.like\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.organic\_metrics.retweet\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.organic\_metrics.reply\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.organic\_metrics.impression\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.organic\_metrics.url\_link\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.organic\_metrics.user\_profile\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics | tweet.fields=promoted\_metrics | 객체 | | 제공되지 않음 | data.promoted\_metrics.like\_count | tweet.fields=promoted\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics.retweet\_count | tweet.fields=promoted\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics.reply\_count | tweet.fields=promoted\_metrics | Int | | 해당 없음 | data.promoted\_metrics.impression\_count | tweet.fields=promoted\_metrics | Int | | 해당 없음 | data.promoted\_metrics.url\_link\_count | tweet.fields=promoted\_metrics | Int | | 해당 없음 | data.promoted\_metrics.user\_profile\_count | tweet.fields=promoted\_metrics | Int | | 기여자 | 해당 없음 | 해당 없음 | | | 엔터티 | data.entities | tweet.fields=entities | Object | | entities.user\_mentions | data.entities.mentions | tweet.fields=entities | 객체 배열 | | entities.symbols | data.entities.cashtags | tweet.fields=entities | 객체 배열 | | entities.hashtags | data.entities.hashtags | tweet.fields=entities | 객체 배열 | | entities.urls | data.entities.urls | tweet.fields=entities | 객체 배열 | | entities.media | includes.media | expansions=attachments.media\_keys | 객체 배열 | | entities.annotations | | tweet.fields=entities,context\_annotations | 객체 | | entities.annotations.context | data.context\_annotations | tweet.fields=entities,context\_annotations | 객체 배열 | | 해당 없음 | data.context\_annotations.domain | tweet.fields=context\_annotations | 객체 | | entities.annotations.context.context\_domain\_id\_str | data.context\_annotations.domain.id | tweet.fields=context\_annotations | 문자열 | | entities.annotations.context.context\_domain\_id | 제공되지 않습니다 | 제공되지 않습니다. 문자열 형식은 data.context\_annotations.domain.id를 참조하세요 | | | entities.annotations.context.context\_domain\_name | data.context\_annotations.domain.name | tweet.fields=context\_annotations | 문자열 | | entities.annotations.context.context\_domain\_description | data.context\_annotations.domain.description | tweet.fields=context\_annotations | 문자열 | | 해당 없음 | data.context\_annotations.entity | tweet.fields=context\_annotations | 객체 | | entities.annotations.context.context\_entity\_id\_str | data.context\_annotations.entity.id | tweet.fields=context\_annotations | 문자열 | | entities.annotations.context.context\_entity\_id | 제공되지 않습니다 | 제공되지 않습니다. 문자열 형식은 data.context\_annotations.entity.id를 참조하세요 | | | entities.annotations.context.context\_entity\_name | data.context\_annotations.entity.name | tweet.fields=context\_annotations | 문자열 | | entities.annotations.context.context\_entity\_description | data.context\_annotations.entity.description | tweet.fields=context\_annotations | 문자열 | | entities.annotations.entity | data.entities.annotations | tweet.fields=entities,context\_annotations | 객체 배열 | | extended\_entities | data.attachments | tweet.fields=attachments | 객체 | | favorited | 제공되지 않음 | 제공되지 않음 | | | retweeted | 제공되지 않음 | 제공되지 않음 | | | retweeted\_status | | | | | possibly\_sensitive | data.possibly\_sensitive | tweet.fields=possibly\_sensitive | 불리언 값 | | lang | data.lang | tweet.fields=lang | 문자열 | | filter\_level | 제공되지 않음 | 제공되지 않음 | | | scopes | 제공되지 않음 | 제공되지 않음 | | | timestamp\_ms | 제공되지 않음 | 제공되지 않음 | | | withheld | data.withheld | tweet.fields=withheld | 객체 배열 | | matching\_rules | matching\_rules | | 객체 배열 | | matching\_rules.id | 제공되지 않음 | 제공되지 않음 | | | matching\_rules.id\_str | matching\_rules.id | 필터 스트림의 기본값 | 문자열 | | matching\_rules.tag | matching\_rules.tag | 필터 스트림의 기본값 | 문자열 |
#### User 객체
| | | | | | :------------------------------------------ | :----------------------------------------------------- | :----------------------------------------------------- | :----------- | | **네이티브 Enriched 데이터 형식** | **Twitter v2 포맷** | **필수 v2 파라미터** | **v2의 type** | | user | includes.users | expansions=author\_id | 객체 배열 | | user.id | 제공되지 않음 | 해당 없음 - includes.users.id 참조 | 문자열 | | user.id\_str | includes.users.id | expansions=author\_id | 문자열 | | user.name | includes.users.name | expansions=author\_id | 문자열 | | user.screen\_name | includes.users.username | expansions=author\_id | 문자열 | | user.location | includes.users.location | expansions=author\_id\&user.fields=location | 객체 | | user.description | includes.users.description | expansions=author\_id\&user.fields=description | 문자열 | | 제공되지 않음 | includes.users.url | expansions=author\_id\&user.fields=url | 문자열 | | user.followers\_count | includes.users.public\_metrics.followers\_count | expansions=author\_id\&user.fields=public\_metrics | 정수 | | user.friends\_count | includes.users.public\_metrics.following\_count | expansions=author\_id\&user.fields=public\_metrics | 정수 | | user.listed\_count | includes.users.public\_metrics.listed\_count | expansions=author\_id\&user.fields=public\_metrics | Int | | user.created\_at | includes.users.created\_at | expansions=author\_id\&user.fields=created\_at | String | | user.favourites\_count | | 제공되지 않음 | | | user.verified | includes.users.verified | expansions=author\_id\&user.fields=verified | Boolean | | user.pinned\_tweet\_id | includes.users.pinned\_tweet\_id | expansions=author\_id\&user.fields=pinned\_tweet\_id | String | | user.statuses\_count | includes.users.public\_metrics.tweet\_count | expansions=author\_id\&user.fields=public\_metrics | Int | | user.profile\_image\_url\_https | includes.users.profile\_image\_url | expansions=author\_id\&user.fields=profile\_image\_url | String | | user.translator\_type | 제공되지 않음 | 제공되지 않음 | | | user.utc\_offset | 제공되지 않음 | 제공되지 않음 | | | user.time\_zone | 제공되지 않음 | 제공되지 않음 | | | user.geo\_enabled | 제공되지 않음 | 제공되지 않음 | | | user.lang | 제공되지 않음 | 제공되지 않음 - Tweet 언어를 기준으로 추론됨 | | | user.contributors\_enabled | 제공되지 않음 | 제공되지 않음 | | | user.is\_translator | 제공되지 않음 | 제공되지 않음 | | | user.profile\_background\_color | 제공되지 않음 | 제공되지 않음 | | | user.profile\_background\_image\_url | 제공되지 않음 | 제공되지 않음 | | | user.profile\_background\_image\_url\_https | 제공되지 않음 | 제공되지 않음 | | | user.profile\_background\_title | 제공되지 않음 | 제공되지 않음 | | | user.profile\_sidebar\_border\_color | 제공되지 않음 | 제공되지 않음 | | | user.profile\_sidebar\_fill\_color | 제공되지 않음 | 제공되지 않음 | | | user.profile\_text\_color | 제공되지 않음 | 제공되지 않음 | | | user.profile\_user\_background\_image | 제공되지 않음 | 제공되지 않음 | | | user.profile\_image\_url | | includes.user.profile\_image\_url을 참조 | | | user.default\_profile | 제공되지 않음 | 제공되지 않음 | | | user.default\_profile\_image | 제공되지 않음 | 제공되지 않음 | | | user.following | 제공되지 않음 | 제공되지 않음 | | | user.follow\_request\_sent | 제공되지 않음 | 제공되지 않음 | | | user.notifications | 제공되지 않음 | 제공되지 않음 | | | user.withheld\_in\_countries | includes.users.withheld | expansions=author\_id\&user.fields=withheld | 객체 | | user.protected | includes.users.protected | expansions=author\_id\&user.fields=protected | 부울 값 | | 제공되지 않음 | includes.users.entities | expansions=author\_id\&user.fields=entities | 객체 | | 제공되지 않음 | includes.users.entities.url | expansions=author\_id\&user.fields=entities | 객체 | | 제공되지 않음 | includes.users.entities.url.urls | expansions=author\_id\&user.fields=entities | 객체 배열 | | 제공되지 않음 | includes.users.entities.url.urls.start | expansions=author\_id\&user.fields=entities | 정수 | | 제공되지 않음 | includes.users.entities.url.urls.end | expansions=author\_id\&user.fields=entities | 정수 | | 제공되지 않음 | includes.users.entities.url.urls.url | expansions=author\_id\&user.fields=entities | 문자열 | | user.url | includes.users.entities.url.urls.expanded\_url | expansions=author\_id\&user.fields=entities | String | | 해당 없음 | includes.users.entities.url.urls.display\_url | expansions=author\_id\&user.fields=entities | String | | 해당 없음 | includes.users.entities.descriptions | expansions=author\_id\&user.fields=entities | 객체 | | 해당 없음 | includes.users.entities.descriptions.hashtags | expansions=author\_id\&user.fields=entities | 객체 배열 | | 해당 없음 | includes.users.entities.descriptions.hashtags.start | expansions=author\_id\&user.fields=entities | Int | | 해당 없음 | includes.users.entities.descriptions.hashtags.end | expansions=author\_id\&user.fields=entities | Int | | user.description에 포함됨 | includes.users.entities.descriptions.hashtags.tag | expansions=author\_id\&user.fields=entities | String | | 해당 없음 | includes.users.entities.descriptions.mentions | expansions=author\_id\&user.fields=entities | 객체 배열 | | 해당 없음 | includes.users.entities.descriptions.mentions.start | expansions=author\_id\&user.fields=entities | Int | | 해당 없음 | includes.users.entities.descriptions.mentions.end | expansions=author\_id\&user.fields=entities | Int | | user.description에 포함되어 있음 | includes.users.entities.descriptions.mentions.username | expansions=author\_id\&user.fields=entities | 문자열 | | 제공되지 않음 | includes.users.entities.descriptions.cashtags | expansions=author\_id\&user.fields=entities | 객체 배열 | | 제공되지 않음 | includes.users.entities.descriptions.cashtags.start | expansions=author\_id\&user.fields=entities | 정수 | | 제공되지 않음 | includes.users.entities.descriptions.cashtags.end | expansions=author\_id\&user.fields=entities | 정수 | | user.description에 포함되어 있음 | includes.users.entities.descriptions.cashtags.tag | expansions=author\_id\&user.fields=entities | 문자열 |
#### Entities 및 Expanded entities 객체
| | | | | | :----------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- | :-------------------------------------------------------------------- | :------------- | | **Native Enriched 포맷** | **Twitter v2 포맷** | **v2 필수 매개변수** | **v2에서의 type** | | entities | data.entities | tweet.fields=entities | 객체 | | entities.hashtags | data.entities.hashtags | tweet.fields=entities | 객체 배열 | | entities.hashtags.indices\[0] | data.entities.hashtags.start | tweet.fields=entities | 정수 | | entities.hashtags.indices\[1] | data.entities.hashtags.end | tweet.fields=entities | 정수 | | entities.hashtags.text | data.entities.hashtags.tag | tweet.fields=entities | 문자열 | | entities.urls | data.entities.urls | tweet.fields=entities | 객체 배열 | | entities.urls.indices\[0] | data.entities.urls.start | tweet.fields=entities | 정수 | | entities.urls.indices\[1] | data.entities.urls.end | tweet.fields=entities | 정수 | | entities.urls.url | data.entities.urls.url | tweet.fields=entities | 문자열 | | entities.urls.expanded\_url | data.entities.urls.expanded\_url | tweet.fields=entities | 문자열 | | entities.urls.display\_url | data.entities.urls.display\_url | tweet.fields=entities | 문자열 | | entities.urls.unwound.url | data.entities.urls.unwound\_url | tweet.fields=entities | 문자열 | | entities.urls.unwound.status | data.entities.urls.status | tweet.fields=entities | 문자열 | | entities.urls.unwound.title | data.entities.urls.title | tweet.fields=entities | 문자열 | | entities.urls.unwound.description | data.entities.urls.description | tweet.fields=entities | 문자열 | | 해당 없음 | data.entities.urls.images | tweet.fields=entities | 객체 배열 | | 해당 없음 | data.entities.urls.images.url | tweet.fields=entities | 문자열 | | 해당 없음 | data.entities.urls.images.width | tweet.fields=entities | 정수 | | 해당 없음 | data.entities.urls.images.height | tweet.fields=entities | 정수 | | entities.user\_mentions | data.entities.mentions | tweet.fields=entities | 객체 배열 | | entities.user\_mentions.indicies\[0] | data.entities.mentions.start | tweet.fields=entities | 정수 | | entities.user\_mentions.indicies\[1] | data.entities.mentions.end | tweet.fields=entities | 정수 | | entities.user\_mentions.screen\_name | data.entities.mentions.username | tweet.fields=entities | 문자열 | | entities.symbols | data.entities.cashtags | tweet.fields=entities | 객체 배열 | | entities.symbols.indices\[0] | data.entities.cashtags.start | tweet.fields=entities | 정수 | | entities.symbols.indices\[1] | data.entities.cashtags.end | tweet.fields=entities | 정수 | | entities.symbols.text | data.entities.cashtags.tag | tweet.fields=entities | 문자열 | | entities.media OR extended\_entities.media | includes.media | expansions=attachments.media\_keys | 객체 배열 | | entities.media.id\_str OR extended\_entities.media.id\_str | includes.media.media\_key | expansions=attachments.media\_keys | 문자열 | | entities.media.id OR extended\_entities.media.id | | 사용할 수 없음 - id는 문자열입니다. | | | entities.media.type OR extended\_entities.media.type | includes.media.media.type | expansions=attachments.media\_keys | 문자열 | | entities.media.indices OR extended\_entities.media.indices | 제공되지 않음 | 제공되지 않음 | | | 제공되지 않음 | includes.media.alt\_text | expansions=attachments.media\_keys\&media.fields=alt\_text | 문자열 | | entities.media.additional\_media\_info OR extended\_entities.media.additional\_media\_info | 제공되지 않음 | 제공되지 않음 | | | entities.media.additional\_media\_info.monetizable OR extended\_entities.media.additional\_media\_info.monetizable | 제공되지 않음 | 제공되지 않음 | | | entities.media.media\_url OR extended\_entities.media.media\_url | | 해당 없음 - includes.media.url 참조 | 문자열 | | entities.media.media\_url\_https OR extended\_entities.media.media\_url\_https | includes.media.url | expansions=attachments.media\_keys\&media.fields=url | 문자열 | | entities.media.url OR extended\_entities.media.url | | | | | entities.media.display\_url OR extended\_entities.media.expanded\_url | | | | | entities.media.expanded\_url | | | | | entities.media.media\_url\_https | includes.media.preview\_image\_url | expansions=attachments.media\_keys\&media.fields=preview\_image\_url | 문자열 | | extended\_entities | data.attachments | tweet\_fields=attachments | 객체 | | extended\_entities | data.attachments.media\_keys | tweet.fields=attachments | 객체 배열 | | 제공되지 않음 | data.attachments.poll\_ids | tweet.fields=attachments | 객체 배열 | | extended\_entities.media.sizes.thumb.w | | 제공되지 않음 | | | extended\_entities.media.sizes.thumb.h | | 제공되지 않음 | | | extended\_entities.media.sizes.thumb.resize | | 제공되지 않음 | | | extended\_entities.media.sizes.large.w | includes.media.height | expansions=attachments.media\_keys\&media.fields=height | | | extended\_entities.media.sizes.large.h | includes.media.width | expansions=attachments.media\_keys\&media.fields=width | | | extended\_entities.media.sizes.large.resize | 제공되지 않음 | 제공되지 않음 | | | extended\_entities.media.sizes.small.w | 제공되지 않음 | 제공되지 않음 | | | extended\_entities.media.sizes.small.h | 제공되지 않음 | 제공되지 않음 | | | extended\_entities.media.sizes.small.resize | 제공되지 않음 | 제공되지 않음 | | | extended\_entities.media.sizes.medium.w | 제공되지 않음 | 제공되지 않음 | | | extended\_entities.media.sizes.medium.h | 제공되지 않음 | 제공되지 않음 | | | extended\_entities.media.sizes.medium.resize | 제공되지 않음 | 제공되지 않음 | | | extended\_entities.media.media\_url\_https | includes.media.preview\_image\_url | expansions=attachments.media\_keys\&media.fields=preview\_image\_url | 문자열 | | extended\_entities.media.video\_info.aspect\_ratio | 제공되지 않음 | 정의되지 않음 | | | extended\_entities.media.variants | 정의되지 않음 | 정의되지 않음 | | | extended\_entities.media.variants.bitrate | 정의되지 않음 | 정의되지 않음 | | | extended\_entities.media.variants.content\_type | 정의되지 않음 | 정의되지 않음 | | | extended\_entities.media.variants.url | 정의되지 않음 | 정의되지 않음 | | | extended\_entities.media.video\_info.duration\_millis | includes.media.duration\_ms | expansions=attachments.media\_keys\&media.fields=duration\_ms | Int | | 정의되지 않음 | includes.media.public\_metrics | expansions=attachments.media\_keys\&media.fields=public\_metrics | Object | | 정의되지 않음 | includes.media.public\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=public\_metrics | Int | | 정의되지 않음 | includes.media.non\_public\_metrics | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Object | | 정의되지 않음 | includes.media.non\_public\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Int | | 정의되지 않음 | includes.media.non\_public\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Int | | 정의되지 않음 | includes.media.non\_public\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 제공되지 않음 | includes.media.non\_public\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 제공되지 않음 | includes.media.non\_public\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 객체 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.promoted\_metric | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 객체 | | 제공되지 않음 | includes.media.promoted\_metric.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수형 | | 제공되지 않음 | includes.media.promoted\_metric.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수형 | | 제공되지 않음 | includes.media.promoted\_metric.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수형 | | 제공되지 않음 | includes.media.promoted\_metric.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수형 | | 제공되지 않음 | includes.media.promoted\_metric.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수형 | | 제공되지 않음 | includes.media.promoted\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수형 |
#### Place 객체
| | | | | | :--------------------------------- | :-------------------------------- | :------------------------------------------------------- | :----------- | | **Native Enriched 형식** | **Twitter v2 형식** | **필수 v2 매개변수** | **v2의 type** | | place | includes.places | expansions=geo.place\_id | 객체 배열 | | place.id | includes.places.id | expansions=geo.place\_id | 문자열 | | place.url | 제공되지 않음 | 제공되지 않음 | | | place.id.place\_type | includes.places.place\_type | expansions=geo.place\_id\&place.fields=place\_type | 문자열 | | place.id.name | includes.places.name | expansions=geo.place\_id\&place.fields=name | 문자열 | | place.id.full\_name | includes.places.full\_name | expansions=geo.place\_id | 문자열 | | place.id.country\_code | includes.places.country\_code | expansions=geo.place\_id\&place.fields=country\_code | 문자열 | | place.id.country | includes.places.country | expansions=geo.place\_id\&place.fields=country | 문자열 | | place.id.contained\_within | includes.places.contained\_within | expansions=geo.place\_id\&place.fields=contained\_within | 배열 | | place.id.bounding\_box.type | includes.places.geo.type | expansions=geo.place\_id\&place.fields=place\_type | 문자열 | | place.id.bounding\_box.coordinates | includes.places.geo.bbox | expansions=geo.place\_id\&place.fields=geo | 배열 | | place.id.attributes | includes.places.properties | expansions=geo.place\_id\&place.fields=geo | 객체 |
#### Poll 객체
| | | | | | :------------------------------- | :------------------------------- | :-------------------------------------------------------------- | :----------- | | **네이티브 Enriched 형식** | **Twitter v2 형식** | **필수 v2 매개변수** | **v2 타입** | | entities.polls | includes.polls | expansions=attachments.poll\_ids | 객체 배열 | | 사용 불가 | includes.polls.id | expansions=attachments.poll\_ids | 문자열 | | entities.poll.options | includes.polls.options | expansions=attachments.poll\_ids | 객체 배열 | | entities.polls.options.position | includes.polls.options.position | expansions=attachments.poll\_ids | Int | | entities.polls.options.text | includes.polls.options.label | expansions=attachments.poll\_ids | 문자열 | | 사용 불가 | includes.polls.options.votes | expansions=attachments.poll\_ids | Int | | 사용 불가 | includes.polls.voting\_status | expansions=attachments.poll\_ids\&poll.fields=voting\_status | 문자열 | | entities.polls.duration\_minutes | includes.polls.duration\_minutes | expansions=attachments.poll\_ids\&poll.fields=duration\_minutes | Int | | entities.polls.end\_datetime | includes.polls.end\_datetime | expansions=attachments.poll\_ids\&poll.fields=end\_datetime | 날짜(ISO 8601) |
### Activity Streams 데이터 형식에서 v2로 마이그레이션
Activity Streams 데이터 형식은 당사의 [enterprise](/ko/x-api/enterprise-gnip-2.0/enterprise-gnip) 제품에서 사용할 수 있습니다. Activity Streams 데이터 형식은 편집된 Tweet 메타데이터를 제공하도록 업데이트되었습니다. Edit Tweet 메타데이터에 대해 더 알아보려면 [Edit Tweets 기본 사항](/ko/x-api/enterprise-gnip-2.0/fundamentals/edit-tweets) 페이지를 확인하세요. 표준 v1.1 엔드포인트를 사용 중이라면 [standard v1.1 to v2 가이드](/ko/x-api/migrate/overview)를 참조하세요. 프리미엄 엔드포인트나 enterprise용 Native Enriched 형식을 사용 중이라면 [Native Enriched to v2 가이드](/ko/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2)를 참조하세요. X API v2는 [게시물](/ko/x-api/fundamentals/data-dictionary#tweet) 및 [user](/ko/x-api/fundamentals/data-dictionary#user) 오브젝트에 대해 새로운 JSON 설계를 도입합니다. * JSON 루트 레벨에서 Activity Streams 형식은 results 배열에 Tweet 오브젝트를 반환하는 반면, X API v2는 data 배열을 반환합니다.  * 리트윗 및 인용 "activities"를 참조하는 대신, X API v2 JSON은 리트윗된 Tweet과 인용된 Tweet을 참조합니다.  * Tweet 오브젝트의 favorites 및 user 오브젝트의 favourites를 모두 사용하는 대신, X API v2는 like라는 용어를 사용합니다.  * X는 값이 없는 JSON 필드(예: 값이 null인 경우)는 페이로드에 기록하지 않는 관례를 채택하고 있습니다. Tweet 및 user 오브젝트의 속성은 null이 아닌 값을 가진 경우에만 포함됩니다.  * v2의 모든 id 필드는 문자열 형식입니다.   새 JSON 형식 변경 사항 외에도, Tweet 오브젝트에 다음을 포함한 새로운 필드 집합이 도입되었습니다: * conversation\_id * reply\_settings * 미디어의 alt\_text * context 및 entities를 포함한 두 개의 새로운 [annotations](/ko/x-api/fundamentals/post-annotations) 필드 * 여러 새로운 [metrics](/ko/x-api/fundamentals/metrics) 필드 * 여러 새로운 [polls](/ko/x-api/fundamentals/data-dictionary#poll) 필드   많은 레거시 및 사용 중단(deprecated) 필드가 제거되거나 대체됩니다: * display\_text\_range * generator * gnip * link * objectType * provider * twitter\_entities.symbols는 data.entities.cashtags로 대체됨 * 특정 twitter\_extended\_entities.media 및 twitter\_entities.media 필드 * twitter\_filter\_level * twitterTimeZone * verb
#### Tweet 객체
| | | | | | :-------------------------------------------- | :--------------------------------------------- | :----------------------------------- | :--------------- | | **Activity Streams 데이터 형식** | **Twitter v2 포맷** | **필수 v2 매개변수** | **v2에서의 type** | | postedTime | data.created\_at | tweet.fields=created\_at | 날짜(ISO 8601) | | generator | 제공되지 않음 | 제공되지 않음 | | | generator.link | 제공되지 않음 | 제공되지 않음 | | | generator.displayName | data.source | tweet.fields=source | 문자열 | | twitter\_lang | data.lang | tweet.fields=lang | 문자열 | | 제공되지 않음 | data.conversation\_id | tweet.fields=conversation\_id | 문자열 | | 제공되지 않음 | data.reply\_settings | tweet.fields=reply\_settings | 문자열 | | 제공되지 않음 | data.possibly\_sensitive | tweet.fields=possibly\_sensitive | 불리언 | | 제공되지 않음 | data.withheld | tweet.fields=withheld | 객체 | | objectType | 제공되지 않음 | 제공되지 않음 | | | verb | 제공되지 않음 | 제공되지 않음 | | | provider | 제공되지 않음 | 제공되지 않음 | | | provider.objectType | 제공되지 않음 | 제공되지 않음 | | | provider.displayName | 제공되지 않음 | 제공되지 않음 | | | provider.link | 제공되지 않음 | 제공되지 않음 | | | link | 제공되지 않음 | 제공되지 않음 | | | display\_text\_range | 제공되지 않음 | 제공되지 않음 | | | object | 제공되지 않음 | 제공되지 않음 | | | object.objectType | 제공되지 않음 | 제공되지 않음 | | | object.id | 제공되지 않음 | 제공되지 않음 | | | object.summary | data.text | 기본값 | String | | object.edit\_history | data.edit\_history\_tweet\_ids | 기본값 | Array | | object.edit\_controls | data.edit\_controls | tweet.fields=edit\_controls | Object | | object.editable | data.edit\_controls.is\_edit\_eligible | tweet.fields=edit\_controls | Boolean | | object.link | 제공되지 않음 | 제공되지 않음 | | | object.postedTime | data.created\_at | tweet.fields=created\_at | 날짜 (ISO 8601) | | actor.id에서 유도됨 | data.author\_id | tweet.fields=created\_at | | | twitter\_filter\_level | 제공되지 않음 | 제공되지 않음 | | | inReplyTo.link의 사용자 이름에서 유도됨 | data.in\_reply\_to\_user\_id | tweet.fields=in\_reply\_to\_user\_id | String | | 제공되지 않음 | data.referenced\_tweets | tweet.fields=referenced\_tweets | 객체 배열 | | 제공되지 않음 | data.referenced\_tweets.type | tweet.fields=referenced\_tweets | String | | inReplyTo.link에서 유도됨 | data.referenced\_tweets.id | tweet.fields=referenced\_tweets | String | | 제공되지 않음 | data.attachments | tweet.fields=attachments | Object | | twitter\_entities.media.id\_str에서 유도됨 | data.attachments.media\_keys | tweet.fields=attachments | Array | | 해당 없음 | data.attachments.poll\_ids | tweet.fields=attachments | 배열 | | twitter\_entities | data.entities | tweet.fields=entities | 객체 | | 해당 없음 | data.entities.annotations | tweet.fields=entities | 객체 배열 | | 해당 없음 | data.entities.annotations.start | tweet.fields=entities | 정수 (Int) | | 해당 없음 | data.entities.annotations.end | tweet.fields=entities | 정수 (Int) | | 해당 없음 | data.entities.annotations.probability | tweet.fields=entities | 부동 소수점 수 (Float) | | 해당 없음 | data.entities.annotations.type | tweet.fields=entities | 문자열 (String) | | 해당 없음 | data.entities.annotations.normalized\_text | tweet.fields=entities | 문자열 (String) | | twitter\_entities.urls | data.entities.urls | tweet.fields=entities | 객체 배열 | | twitter\_entities.urls.indices\[0] | data.entities.urls.start | tweet.fields=entities | 정수 (Int) | | twitter\_entities.urls.indices\[1] | data.entities.urls.end | tweet.fields=entities | 정수 | | twitter\_entities.urls.url | data.entities.urls.url | tweet.fields=entities | 문자열 | | twitter\_entities.urls.expanded\_url | data.entities.urls.expanded\_url | tweet.fields=entities | 문자열 | | twitter\_entities.urls.display\_url | data.entities.urls.display\_url | tweet.fields=entities | 문자열 | | 해당 없음 | data.entities.urls.images | tweet.fields=entities | 객체 배열 | | 해당 없음 | data.entities.urls.images.url | tweet.fields=entities | 문자열 | | 해당 없음 | data.entities.urls.images.width | tweet.fields=entities | 정수 | | 해당 없음 | data.entities.urls.images.height | tweet.fields=entities | 정수 | | gnip.urls.expanded\_status | data.entities.urls.status | tweet.fields=entities | 정수 | | gnip.urls.expanded\_url\_title | data.entities.urls.title | tweet.fields=entities | 문자열 | | gnip.urls.expanded\_url\_description | data.entities.urls.description | tweet.fields=entities | 문자열 | | gnip.urls.expanded\_url | data.entities.urls.unwound\_url | tweet.fields=entities | 문자열 | | twitter\_entities.symbols | data.entities.cashtags | tweet.fields=entities | 객체 배열 | | twitter\_entities.symbols.indices\[0] | data.entities.cashtags.start | tweet.fields=entities | 정수 | | twitter\_entities.symbols.indices\[1] | data.entities.cashtags.end | tweet.fields=entities | 정수 | | twitter\_entities.symbols.text | data.entities.cashtags.tag | tweet.fields=entities | 문자열 | | twitter\_entities.hashtags | data.entities.hashtags | tweet.fields=entities | 객체 배열 | | twitter\_entities.hashtags.indices\[0] | data.entities.hashtags.start | tweet.fields=entities | 정수 | | twitter\_entities.hashtags.indices\[1] | data.entities.hashtags.end | tweet.fields=entities | 정수 | | twitter\_entities.hashtags.text | data.entities.hashtags.tag | tweet.fields=entities | 문자열 | | twitter\_entities.user\_mentions | data.entities.mentions | tweet.fields=entities | 객체 배열(Object 배열) | | twitter\_entities.user\_mentions.indices\[0] | data.entities.mentions.start | tweet.fields=entities | 정수(Int) | | twitter\_entities.user\_mentions.indices\[1] | data.entities.mentions.end | tweet.fields=entities | 정수(Int) | | twitter\_entities.user\_mentions.screen\_name | data.entities.mentions.tag | tweet.fields=entities | 문자열(String) | | twitter\_entities.user\_mentions.id\_str | data.entities.mentions.id | tweet.fields=entities | 문자열(String) | | twitter\_entities.user\_mentions.id | 해당 없음 | 해당 없음 | | | 해당 없음 | data.context\_annotations | tweet.fields=context\_annotations | 객체 배열(Object 배열) | | 해당 없음 | data.context\_annotations.domain | tweet.fields=context\_annotations | 객체(Object) | | 해당 없음 | data.context\_annotations.domain.id | tweet.fields=context\_annotations | 문자열(String) | | 해당 없음 | data.context\_annotations.domain.name | tweet.fields=context\_annotations | 문자열(String) | | 해당 없음 | data.context\_annotations.domain.description | tweet.fields=context\_annotations | String | | 해당 없음 | data.context\_annotations.entity | tweet.fields=context\_annotations | Object | | 해당 없음 | data.context\_annotations.entity.id | tweet.fields=context\_annotations | String | | 해당 없음 | data.context\_annotations.entity.name | tweet.fields=context\_annotations | String | | 해당 없음 | data.context\_annotations.entity.description | tweet.fields=context\_annotations | String | | geo | data.geo | tweet.fields=geo | Object | | location.link에서 파생된 값 | data.geo.place\_id | tweet.fields=geo | String | | 해당 없음 | data.public\_metrics | tweet.fields=public\_metrics | Object | | favoritesCount | data.public\_metrics.like\_count | tweet.fields=public\_metrics | Int | | retweetCount | data.public\_metrics.retweet\_count | tweet.fields=public\_metrics | Int | | 해당 없음 | data.public\_metrics.quote\_count | tweet.fields=public\_metrics | Int | | 해당 없음 | data.public\_metrics.reply\_count | tweet.fields=public\_metrics | Int | | 해당 없음 | data.non\_public\_metrics | tweet.fields=non\_public\_metrics | Object | | 해당 없음 | data.non\_public\_metrics.impression\_count | tweet.fields=non\_public\_metrics | Int | | 해당 없음 | data.non\_public\_metrics.url\_link\_count | tweet.fields=non\_public\_metrics | Int | | 해당 없음 | data.non\_public\_metrics.user\_profile\_count | tweet.fields=non\_public\_metrics | Int | | 해당 없음 | data.organic\_metrics | tweet.fields=organic\_metrics | Object | | 해당 없음 | data.organic\_metrics.like\_count | tweet.fields=organic\_metrics | Int | | 해당 없음 | data.organic\_metrics.retweet\_count | tweet.fields=organic\_metrics | Int | | 해당 없음 | data.organic\_metrics.reply\_count | tweet.fields=organic\_metrics | Int | | 해당 없음 | data.organic\_metrics.impression\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.organic\_metrics.url\_link\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.organic\_metrics.user\_profile\_count | tweet.fields=organic\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics | tweet.fields=promoted\_metrics | Object | | 제공되지 않음 | data.promoted\_metrics.like\_count | tweet.fields=promoted\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics.retweet\_count | tweet.fields=promoted\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics.reply\_count | tweet.fields=promoted\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics.impression\_count | tweet.fields=promoted\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics.url\_link\_count | tweet.fields=promoted\_metrics | Int | | 제공되지 않음 | data.promoted\_metrics.user\_profile\_count | tweet.fields=promoted\_metrics | Int | | gnip.profileLocations | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.address | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.address.country | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.address.countryCode | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.displayName | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.geo | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.geo.coordinates | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.geo.type | 정의되지 않음 | 정의되지 않음 | | | gnip.profileLocations.objectType | 정의되지 않음 | 정의되지 않음 | |
#### User 객체
| | | | | | :-------------------------- | :---------------------------------------------------- | :----------------------------------------------------- | :------------- | | **Activity Streams 데이터 형식** | **Twitter v2 형식** | **v2 필수 매개변수** | **v2에서의 type** | | actor | includes.users | expansions=author\_id | 객체 배열 | | actor.id에서 파생됨 | includes.users.id | expansions=author\_id | 문자열 | | actor.displayName | includes.users.name | expansions=author\_id | 문자열 | | actor.preferredUsername | includes.users.username | expansions=author\_id | 문자열 | | actor.postedTime | includes.users.created\_at | expansions=author\_id\&user.fields=created\_at | 날짜 (ISO 8601) | | actor.summary | includes.users.description | expansions=author\_id\&user.fields=description | 문자열 | | 제공되지 않음 | includes.users.pinned\_tweet\_id | expansions=author\_id\&user.fields=pinned\_tweet\_id | 문자열 | | 제공되지 않음 | includes.users.protected | expansions=author\_id\&user.fields=protected | 불리언 | | actor.link | 제공되지 않음 | 제공되지 않음 - includes.users.username을 기반으로 구성됨 | | | actor.twitterTimeZone | 제공되지 않음 | 제공되지 않음 - Tweet의 created\_at에서 추론됨 | | | actor.utcOffset | 제공되지 않음 | 제공되지 않음 - Tweet의 created\_at 값에서 추론됨 | | | actor.favoritesCount | 제공되지 않음 | 제공되지 않음 | | | actor.followersCount | includes.users.public\_metrics.followers\_count | expansions=author\_id\&user.fields=public\_metrics | Int | | actor.friendsCount | includes.users.public\_metrics.following\_count | expansions=author\_id\&user.fields=public\_metrics | Int | | actor.listedCount | includes.users.public\_metrics.listed\_count | expansions=author\_id\&user.fields=public\_metrics | Int | | actor.statusesCount | includes.users.public\_metrics.tweet\_count | expansions=author\_id\&user.fields=public\_metrics | Int | | actor.languages\[] | 제공되지 않음 | 제공되지 않음 - Tweet의 lang 값에서 추론됨 | | | actor.location.displayName | includes.users.location | expansions=author\_id\&user.fields=location | String | | actor.image | includes.users.profile\_image\_url | expansions=author\_id\&user.fields=profile\_image\_url | String | | actor.links | includes.users.url | expansions=author\_id\&user.fields=url | String | | actor.verified | includes.users.verified | expansions=author\_id\&user.fields=verified | Boolean | | 제공되지 않음 | includes.users.withheld | expansions=author\_id\&user.fields=withheld | 객체 | | 해당 없음 | includes.users.entities | expansions=author\_id\&user.fields=entities | 객체 | | 해당 없음 | includes.users.entities.url | expansions=author\_id\&user.fields=entities | 객체 | | actor.links | includes.users.entities.url.urls | expansions=author\_id\&user.fields=entities | 객체 배열 | | 해당 없음 | includes.users.entities.url.urls.start | expansions=author\_id\&user.fields=entities | Int | | 해당 없음 | includes.users.entities.url.urls.end | expansions=author\_id\&user.fields=entities | Int | | 해당 없음 | includes.users.entities.url.urls.url | expansions=author\_id\&user.fields=entities | 문자열 | | actor.links.href | includes.users.entities.url.urls.expanded\_url | expansions=author\_id\&user.fields=entities | 문자열 | | 해당 없음 | includes.users.entities.url.urls.display\_url | expansions=author\_id\&user.fields=entities | 문자열 | | 해당 없음 | includes.users.entities.description | expansions=author\_id\&user.fields=entities | 객체 | | 해당 없음 | includes.users.entities.description.hashtags | expansions=author\_id\&user.fields=entities | 객체 배열 | | 해당 없음 | includes.users.entities.description.hashtags.start | expansions=author\_id\&user.fields=entities | 정수 | | 해당 없음 | includes.users.entities.description.hashtags.end | expansions=author\_id\&user.fields=entities | 정수 | | 해당 없음 | includes.users.entities.description.hashtags.tag | expansions=author\_id\&user.fields=entities | 문자열 | | 해당 없음 | includes.users.entities.description.mentions | expansions=author\_id\&user.fields=entities | 객체 배열 | | 해당 없음 | includes.users.entities.description.mentions.start | expansions=author\_id\&user.fields=entities | 정수 | | 해당 없음 | includes.users.entities.description.mentions.end | expansions=author\_id\&user.fields=entities | 정수 | | 해당 없음 | includes.users.entities.description.mentions.username | expansions=author\_id\&user.fields=entities | 문자열 | | 해당 없음 | includes.users.entities.description.cashtags | expansions=author\_id\&user.fields=entities | 객체 배열 | | 해당 없음 | includes.users.entities.description.cashtags.start | expansions=author\_id\&user.fields=entities | 정수 | | 해당 없음 | includes.users.entities.description.cashtags.end | expansions=author\_id\&user.fields=entities | 정수형(Int) | | 해당 없음 | includes.users.entities.description.cashtags.tag | expansions=author\_id\&user.fields=entities | 문자열(String) |
#### Poll 객체
| | | | | | :---------------------- | :------------------------------- | :-------------------------------------------------------------- | :------------ | | **Activity Streams 형식** | **Twitter v2 형식** | **필수 v2 매개변수** | **v2 타입** | | 제공되지 않음 | includes.polls | expansions=attachments.poll\_ids | 객체 배열 | | 제공되지 않음 | includes.polls.id | expansions=attachments.poll\_ids | 문자열 | | 제공되지 않음 | includes.polls.options | expansions=attachments.poll\_ids | 객체 배열 | | 제공되지 않음 | includes.polls.options.position | expansions=attachments.poll\_ids | Int | | 제공되지 않음 | includes.polls.options.label | expansions=attachments.poll\_ids | 문자열 | | 제공되지 않음 | includes.polls.options.votes | expansions=attachments.poll\_ids | Int | | 제공되지 않음 | includes.polls.voting\_status | expansions=attachments.poll\_ids\&poll.fields=voting\_status | 문자열 | | 제공되지 않음 | includes.polls.duration\_minutes | expansions=attachments.poll\_ids\&poll.fields=duration\_minutes | Int | | 제공되지 않음 | includes.polls.end\_datetime | expansions=attachments.poll\_ids\&poll.fields=end\_datetime | 날짜 (ISO 8601) |
#### Place 객체
| | | | | | :------------------------------ | :----------------------------- | :--------------------------------------------------- | :----------- | | **Activity Streams 형식** | **Twitter v2 형식** | **필수 v2 매개변수** | **v2의 type** | | location | includes.places | expansions=geo.place\_id | 객체 배열 | | location.displayName | includes.places.full\_name | expansions=geo.place\_id | 문자열 | | location.link에서 파싱된 값 | includes.places.id | expansions=geo.place\_id | 문자열 | | location.name | includes.places.name | expansions=geo.place\_id\&place.fields=name | 문자열 | | location.country\_code | includes.places.country | expansions=geo.place\_id\&place.fields=country | 문자열 | | location.twitter\_place\_type | includes.places.place\_type | expansions=geo.place\_id\&place.fields=place\_type | 문자열 | | location.twitter\_country\_code | includes.places.country\_code | expansions=geo.place\_id\&place.fields=country\_code | 문자열 | | location.geo | includes.places.geo | expansions=geo.place\_id\&place.fields=geo | 객체 | | location.geo.type | includes.places.geo.type | expansions=geo.place\_id\&place.fields=geo | 문자열 | | location.geo.coordinates | includes.places.geo.bbox | expansions=geo.place\_id\&place.fields=geo | 배열 | | 제공되지 않음 | includes.places.geo.properties | expansions=geo.place\_id\&place.fields=geo | 객체 |
#### 미디어 객체
| | | | | | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- | :-------------------------------------------------------------------- | :----------- | | **Activity Streams 포맷** | **Twitter v2 형식** | **필수 v2 파라미터** | **v2의 type** | | twitter\_entities.media OR twitter\_extended\_entities.media | includes.media | expansions=attachments.media\_keys | 객체 배열 | | twitter\_entities.media.id\_str OR twitter\_extended\_entities.media.id\_str | includes.media.media\_key | expansions=attachments.media\_keys | 문자열 | | twitter\_entities.media.id OR twitter\_extended\_entities.media.id | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.indices OR twitter\_extended\_entities.media.indices | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.additional\_media\_info OR twitter\_extended\_entities.media.additional\_media\_info | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.additional\_media\_info.monetizable OR twitter\_extended\_entities.media.additional\_media\_info.monetizable | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.media\_url OR twitter\_extended\_entities.media.media\_url | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.media\_url\_https OR twitter\_extended\_entities.media.media\_url\_https | includes.media.preview\_image\_url | expansions=attachments.media\_keys\&media.fields=preview\_image\_url | 문자열 | | twitter\_entities.media.url OR twitter\_extended\_entities.media.url | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.display\_url OR twitter\_extended\_entities.media.display\_url | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.expanded\_url OR twitter\_extended\_entities.media.expanded\_url | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.type OR twitter\_extended\_entities.media.type | includes.media.type | expansions=attachments.media\_keys | 문자열 | | twitter\_entities.media.sizes OR twitter\_extended\_entities.media.sizes | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.thumb OR twitter\_extended\_entities.media.sizes.thumb | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.thumb.h OR twitter\_extended\_entities.media.sizes.thumb.h | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.thumb.w OR twitter\_extended\_entities.media.sizes.thumb.w | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.thumb.resize OR twitter\_extended\_entities.media.sizes.thumb.resize | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.small OR twitter\_extended\_entities.media.sizes.small | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.small.h OR twitter\_extended\_entities.media.sizes.small.h | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.small.w OR twitter\_extended\_entities.media.sizes.small.w | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.small.resize OR twitter\_extended\_entities.media.sizes.small.resize | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.medium OR twitter\_extended\_entities.media.sizes.medium | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.medium.h OR twitter\_extended\_entities.media.sizes.medium.h | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.medium.w OR twitter\_extended\_entities.media.sizes.medium.w | 제공되지 않음 | 제공되지 않음 | | | twitter\_entities.media.sizes.medium.resize OR twitter\_extended\_entities.media.sizes.medium.resize | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_entities.media.sizes.large OR twitter\_extended\_entities.media.sizes.large | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_entities.media.sizes.large.h OR twitter\_extended\_entities.media.sizes.large.h | includes.media.height | expansions=attachments.media\_keys\&media.fields=height | Int | | twitter\_entities.media.sizes.large.w OR twitter\_extended\_entities.media.sizes.large.w | includes.media.width | expansions=attachments.media\_keys\&media.fields=width | Int | | twitter\_entities.media.sizes.large.resize OR twitter\_extended\_entities.media.sizes.large.resize | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_extended\_entities.media.video\_info | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_extended\_entities.media.video\_info.aspect\_ratio | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_extended\_entities.media.video\_info.duration\_millis | includes.media.duration\_ms | expansions=attachments.media\_keys\&media.fields=duration\_ms | Int | | twitter\_extended\_entities.media.video\_info.variants | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_extended\_entities.media.video\_info.variants.bitrate | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_extended\_entities.media.video\_info.variants.content\_type | 사용할 수 없음 | 사용할 수 없음 | | | twitter\_extended\_entities.media.video\_info.variants.url | 사용할 수 없음 | 사용할 수 없음 | | | 사용할 수 없음 | includes.media.alt\_text | expansions=attachments.media\_keys\&media.fields=alt\_text | 문자열 | | 지원되지 않음 | includes.media.public\_metrics | expansions=attachments.media\_keys\&media.fields=public\_metrics | 객체 | | 지원되지 않음 | includes.media.public\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=public\_metrics | 정수 | | 지원되지 않음 | includes.media.non\_public\_metrics | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 객체 | | 지원되지 않음 | includes.media.non\_public\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 지원되지 않음 | includes.media.non\_public\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 지원되지 않음 | includes.media.non\_public\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 지원되지 않음 | includes.media.non\_public\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 지원되지 않음 | includes.media.non\_public\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 정수 | | 지원되지 않음 | includes.media.organic\_metrics | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 객체 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.organic\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | 정수 | | 제공되지 않음 | includes.media.promoted\_metrics | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 객체 | | 제공되지 않음 | includes.media.promoted\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수 | | 제공되지 않음 | includes.media.promoted\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수 | | 제공되지 않음 | includes.media.promoted\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 정수 | | 제공되지 않음 | includes.media.promoted\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | Int | | 제공되지 않음 | includes.media.promoted\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | Int | | 제공되지 않음 | includes.media.promoted\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | Int |
#### 매칭 규칙 객체
| | | | | | :------------------------------- | :------------------ | :------------- | :------------- | | **Activity Streams 형식** | **Twitter v2 형식** | **필수 v2 매개변수** | **v2에서의 type** | | gnip.matching\_rules | matching\_rules | 필터링된 스트림에서 기본값 | 객체 배열 | | gnip.matching\_rules.tag | matching\_rules.tag | 필터링된 스트림에서 기본값 | 문자열 | | gnip.matching\_rules.tag.id | 제공되지 않음 | 제공되지 않음 | | | gnip.matching\_rules.tag.id\_str | matching\_rules.id | 필터링된 스트림에서 기본값 | 문자열 |
### 시각적 데이터 포맷 마이그레이션 도구
시각적 데이터 포맷 마이그레이션 도구는 웹 애플리케이션으로, 특정 Tweet 또는 user 객체에 대해 [X API v1.1 데이터 포맷](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview)에서 [X API v2 포맷](/ko/x-api/fundamentals/data-dictionary)으로 매핑되는 필드를 시각적으로 보여줍니다. 이 매핑을 확인하려면 애플리케이션에 Tweet ID 또는 user ID를 입력하면 됩니다. 이 앱을 사용하려면 Twitter 계정으로 로그인해야 합니다.