> ## 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.

# 정렬

정렬은 대부분의 Ads API 컬렉션 엔드포인트(객체 목록을 반환하는 엔드포인트)에서 사용할 수 있습니다. 엔드포인트에 따라 정렬에 사용할 수 있는 매개변수가 서로 다릅니다. 이러한 매개변수로 반환되는 대부분의 필드(`id`와 ENUM 값 제외)는 정렬할 수 있습니다.

| API 컬렉션                                                                                 | 정렬 가능한 매개변수                                                                                                                                                        |
| :-------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Accounts](/ko/x-ads-api/campaign-management#accounts)                                  | `created_at`, `updated_at`, `deleted`, `name`                                                                                                                      |
| [Funding Instruments](/ko/x-ads-api/campaign-management#funding-instruments)            | `created_at`, `updated_at`, `deleted`, `funded_amount_local_micro`, `start_time`, `end_time`                                                                       |
| [Campaigns](/ko/x-ads-api/campaign-management#campaigns)                                | `created_at`, `updated_at`, `deleted`, `name`, `start_time`, `end_time`, `daily_budget_amount_local_micro`, `total_budget_amount_local_micro`, `standard_delivery` |
| [Line Items](/ko/x-ads-api/campaign-management#line-items)                              | `created_at`, `updated_at`, `deleted`, `bid_amount_local_micro`                                                                                                    |
| [Cards](https://developer.x.com/en/docs/ads/creatives/api-reference/image-app-download) | `created_at`, `updated_at`, `deleted`, `name`                                                                                                                      |
| [Promoted Accounts](/ko/x-ads-api/campaign-management#advertiser-api)                   | `created_at`, `updated_at`, `deleted`, `paused`                                                                                                                    |
| [Promoted Tweets](/ko/x-ads-api/campaign-management#promoted-tweets)                    | `created_at`, `updated_at`, `deleted`, `paused`                                                                                                                    |
| [App Event Tags](/ko/x-ads-api/measurement/mobile-conversions#app-event-tags)           | `created_at`, `updated_at`, `deleted`, `post_view_attribution_window`, `post_engagement_attribution_window`, `assisted_conversion`, `provider_app_event_name`      |

<div id="getting-started">
  ## 시작하기
</div>

API 요청에 `sort_by=[attribute name]-[asc/desc]` 를 단순히 추가하면 됩니다. 여기서 attribute는 GET 요청의 JSON 응답에 포함되어 반환되는 유효한 속성이어야 합니다.

예를 들어, 이름을 기준으로 알파벳 순으로 정렬하려면 `?name-asc` 를, 역순으로 정렬하려면 `?name-desc` 를 사용할 수 있습니다.

<div id="going-deeper">
  ## 더 자세히 살펴보기
</div>

아래는 `bid_amount_local_micro`를 기준으로 모든 line item을 내림차순으로 반환하는 API 요청 예시입니다:

`twurl -H ads-api.x.com "/5/accounts/k9w0oe/line\_items?sort\_by=bid\_amount\_local_micro-desc"`

```json theme={null}
{
  "request": {
    "params": {
      "sort_by": \[
        "bid\_amount\_local_micro-desc"
      \],
      "account_id": "k9w0oe"
    }
  },
  "data": \[
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 3000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1iw6k",
      "paused": true,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-09T02:11:32Z",
      "updated_at": "2015-05-27T23:01:45Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1kv71",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 3000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "FOLLOW",
      "product\_type": "PROMOTED\_ACCOUNT",
      "bid_unit": "FOLLOW",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "FOLLOWERS",
      "id": "1nlqp",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-10-20T18:57:18Z",
      "updated_at": "2014-10-20T18:57:18Z",
      "include_sentiment": null,
      "campaign_id": "1pjkp",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2500000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1iw6l",
      "paused": true,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-09T02:11:54Z",
      "updated_at": "2014-09-17T06:23:23Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1kv71",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2500000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1iw9q",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-09T03:11:46Z",
      "updated_at": "2014-09-09T03:26:17Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1kv71",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2500000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1iw9r",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-09T03:12:02Z",
      "updated_at": "2014-09-09T03:30:44Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1kv71",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "TWITTER_TIMELINE",
        "TWITTER_PROFILE"
      \],
      "bid\_amount\_local_micro": 2000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1kkze",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-24T01:18:20Z",
      "updated_at": "2015-08-30T04:41:34Z",
      "include_sentiment": null,
      "campaign_id": "1mj4h",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "TWITTER_TIMELINE",
        "TWITTER_PROFILE"
      \],
      "bid\_amount\_local_micro": 2000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1kkzk",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-24T01:23:06Z",
      "updated_at": "2015-08-30T04:41:34Z",
      "include_sentiment": null,
      "campaign_id": "1mj4n",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1kkzq",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-24T01:25:06Z",
      "updated_at": "2014-09-24T01:34:20Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1mj48",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": null,
      "objective": "ENGAGEMENTS",
      "id": "1kkzr",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-24T01:25:09Z",
      "updated_at": "2014-09-24T01:34:41Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1mj48",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": 6000000,
      "objective": "ENGAGEMENTS",
      "id": "1kl0e",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-24T01:42:49Z",
      "updated_at": "2014-09-24T01:51:25Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1mj57",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": 12000000,
      "objective": "ENGAGEMENTS",
      "id": "1kl0g",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-24T01:43:19Z",
      "updated_at": "2014-09-24T01:51:40Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1mj57",
      "creative_source": "MANUAL",
      "deleted": false
    },
    {
      "bid_type": "MAX",
      "name": "제목 없음",
      "placements": \[
        "ALL\_ON\_TWITTER"
      \],
      "bid\_amount\_local_micro": 2000000,
      "automatically\_select\_bid": false,
      "advertiser_domain": null,
      "primary\_web\_event_tag": null,
      "charge_by": "ENGAGEMENT",
      "product\_type": "PROMOTED\_TWEETS",
      "bid_unit": "ENGAGEMENT",
      "total\_budget\_amount\_local\_micro": 6000000,
      "objective": "ENGAGEMENTS",
      "id": "1kl0l",
      "paused": false,
      "optimization": "DEFAULT",
      "categories": \[

      \],
      "currency": "USD",
      "created_at": "2014-09-24T01:45:09Z",
      "updated_at": "2014-09-24T01:51:54Z",
      "include\_sentiment": "POSITIVE\_ONLY",
      "campaign_id": "1mj5d",
      "creative_source": "MANUAL",
      "deleted": false
    }
  \],
  "next_cursor": null
}
```
