### Example GET Request for Active Entities

Source: https://docs.x.com/x-ads-api/analytics

This example demonstrates how to construct a GET request to retrieve active entities for a specific account, filtering by entity type and a date range. Ensure the account ID and time parameters are correctly formatted.

```http
GET https://ads-api.x.com/12/stats/accounts/18ce54d4x5t/active_entities?entity=PROMOTED_TWEET&start_time=2019-02-28&end_time=2019-03-01
```

--------------------------------

### GET accounts/:account_id/tweet_previews Request Example

Source: https://docs.x.com/x-ads-api/creatives/reference

This example demonstrates how to make a GET request to the tweet_previews endpoint to preview multiple published Tweets. Ensure the tweet_ids correspond to the specified tweet_type.

```bash
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/tweet_previews?tweet_ids=1122911801354510336,1102836745790316550&tweet_type=PUBLISHED
```

--------------------------------

### Example GET Request for Campaign Reach Analytics

Source: https://docs.x.com/x-ads-api/analytics

This example demonstrates how to construct a GET request to retrieve reach and average frequency analytics for specific campaigns. Ensure all required parameters like campaign_ids, start_time, and end_time are correctly formatted.

```HTTP
GET https://ads-api.x.com/12/stats/accounts/18ce54d4x5t/reach/campaigns?campaign_ids=8fgzf&start_time=2017-05-19&end_time=2017-05-26
```

--------------------------------

### Example GET Request for App Event Tag

Source: https://docs.x.com/x-ads-api/measurement/mobile-conversions

This is an example of a GET request to retrieve information about an app event tag. It includes the account ID and the app event tag ID in the URL.

```http
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags/jhp
```

--------------------------------

### Example Response for Updating a Product Set

Source: https://docs.x.com/x-ads-api/catalog-management/reference

This is an example response for a successful product set update operation.

```json
{
  "request": {
    "params": {
      "product_catalog_id": "1576873894266273792",
      "id": "1564499160082001920",
      "product_keys": [
        "1576768397127606272",
        "1547080787865939969"
      ],
      "name": "Update name product catalogs"
    }
  },
  "data": {
    "name": "Update name product catalogs",
    "description": "Manual product Sets description",
    "product_ids": [
      "test-12345",
      "123abc"
    ],
    "processing_status": "DONE",
    "id": "1564499160082001920",
    "filters": [],
    "type": "MANUAL"
  }
}
```

--------------------------------

### Example Mobile Conversion Event Request

Source: https://docs.x.com/x-ads-api/measurement/mobile-conversions

This is an example of a GET request to log a mobile conversion event. Ensure all required parameters like app_id, os_type, conversion_type, and device identifiers are included.

```HTTP
https://ads-api.x.com/12/conversion_event?app_id=333903271&os_type=IOS&hashed_device_id=ABCD1234XYZ&conversion_type=INSTALL&conversion_time=2013-04-16T07:00:00.123Z&click_window=14&view_through_window=1
```

--------------------------------

### Example Response for Deleting a Product Set

Source: https://docs.x.com/x-ads-api/catalog-management/reference

This is an example response for a successful product set deletion.

```json
{
  "request": {
    "params": {
      "product_catalog_id": "1547080201384865792",
      "id": "1559806000097787904"
    }
  },
  "data": {
    "name": "Filtered Product",
    "description": "Filtered product Set",
    "product_ids": [],
    "processing_status": "DONE",
    "id": "1559806000097787904",
    "filters": [
      {
        "attribute": "price",
        "operator": "GREATER_THAN",
        "value": "100.00 USD"
      }
    ],
    "type": "FILTERED"
  }
}
```

--------------------------------

### Get User Settings Response

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example response for retrieving user settings, including notification email and contact information.

```JSON
{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "user_id": "756201191646691328"
    }
  },
  "data": {
    "notification_email": "user@domain.com",
    "contact_phone": "",
    "contact_phone_extension": ""
  }
}
```

--------------------------------

### Get Line Item Placements Response

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example response showing product types and their associated valid placements. The response is structured as a list of objects, each containing a product type and an array of placement arrays.

```JSON
{
  "data": [
    {
      "product_type": "PROMOTED_ACCOUNT",
      "placements": [
        [
          "ALL_ON_TWITTER"
        ],
        [
          "TWITTER_TIMELINE"
        ]
      ]
    }
  ],
  "request": {
    "params": {
      "product_type": "PROMOTED_ACCOUNT"
    }
  }
}
```

--------------------------------

### Example Response from GET Accounts Endpoint

Source: https://docs.x.com/x-ads-api/getting-started

This is a sample JSON response from the GET accounts endpoint, illustrating the structure of data returned, including account details like name, ID, and approval status.

```json
{
  "request": {
    "params": {}
  },
  "data": [
   {
    "name": "Furni",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-04-06T07:00:00Z",
    "id": "18ce54ayf0z",
    "created_at": "2016-04-07T14:40:15Z",
    "salt": "b88939e5cabbca720159cb3659d73c06",
    "updated_at": "2017-02-08T08:49:53Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
     }
   ]
}
```

--------------------------------

### Example Response for Retrieving Scheduled Feeds

Source: https://docs.x.com/x-ads-api/catalog-management/reference

This is an example response showing details of scheduled feeds for a product catalog.

```json
{
  "request": {
    "params": {
      "product_catalog_id": "1547080201384865792"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "start_time": "01:30",
      "product_catalog_id": "1547080201384865792",
      "feed_url": "https://test212/file.csv",
      "feed_format": "CSV",
      "id": "1564821386714947589",
      "created_at": "2022-08-31T03:44:26.000Z",
      "frequency": "DAILY",
      "repeat": null,
      "updated_at": "2022-09-27T08:47:23.000Z",
      "time_zone": "America/New_York"
    }
  ]
}
```

--------------------------------

### Video Website Card Example

Source: https://docs.x.com/x-ads-api/creatives/reference

Example JSON structure for a VIDEO_WEBSITE card type, including video poster URL and dimensions.

```json
{
    "video_poster_url": "https://pbs.twimg.com/amplify_video_thumb/867520357225418752/img/E3pnXM0sCKnRsFih.jpg",
    "video_poster_width": "16",
    "deleted": false,
    "card_type": "VIDEO_WEBSITE"
  }
}
```

--------------------------------

### Example Response for Creating Product Catalog

Source: https://docs.x.com/x-ads-api/catalog-management/reference

Shows the response after successfully creating a product catalog, confirming the catalog's ID and name.

```json
{
  "request": {
    "params": {
      "name": "catalog_123_abc_def"
    }
  },
  "data": {
    "id": "1559934724822351872",
    "name": "catalog_123_abc_def"
  }
}
```

--------------------------------

### GET accounts/:account_id/tweets Example Request

Source: https://docs.x.com/x-ads-api/creatives/reference

Example of a GET request to retrieve specific published tweets for an account, with user object trimmed.

```HTTP
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/tweets?tweet_ids=1166476031668015104&tweet_type=PUBLISHED&trim_user=true
```

--------------------------------

### Example Product Response

Source: https://docs.x.com/x-ads-api/catalog-management/reference

This is an example response when retrieving products. It includes details such as inventory, price, description, and links, along with pagination information like the next cursor.

```json
{
  "request": {
    "params": {
      "product_catalog_id": "1547080201384865792",
      "count": 1
    }
  },
  "next_cursor": "1547080787865939970",
  "data": [
    {
      "inventory": 5,
      "custom_label_2": null,
      "item_group_key": null,
      "additional_image_link": null,
      "size": null,
      "mobile_link": null,
      "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
      "price": "20.00 USD",
      "gtin": null,
      "age_group": "teen",
      "availability": "in stock",
      "product_type": "",
      "color": null,
      "custom_label_3": null,
      "item_group_id": null,
      "brand": "X",
      "product_key": "1547080787865939969",
      "mpn": null,
      "id": "123abc",
      "custom_label_4": null,
      "condition": "new",
      "custom_label_0": null,
      "sale_price": null,
      "custom_label_1": null,
      "link": "https://www.x.com/twtr_blue",
      "sale_price_effective_date": null,
      "image_link": "https://t.co/jeans_1.jpg",
      "title": "My shoes",
      "google_product_category": "Apparel & Accessories > Shoes",
      "gender": "female"
    }
  ]
}
```

--------------------------------

### Create Campaign Request

Source: https://docs.x.com/x-ads-api/campaign-management/reference

This example shows how to construct a POST request to create a new campaign. It includes essential parameters like funding instrument ID, name, daily budget, and status.

```HTTP
POST https://ads-api.x.com/12/accounts/18ce54d4x5t/campaigns?funding_instrument_id=lygyi&name=demo&daily_budget_amount_local_micro=140000000&entity_status=PAUSED&budget_optimization=CAMPIAGN&standard_delivery=false
```

--------------------------------

### GET Account Apps Response

Source: https://docs.x.com/x-ads-api/campaign-management/reference

This is an example JSON response for the GET account_apps endpoint, showing account app details.

```JSON
{
  "request": {
    "params": {
      "account_ids": [
        "18ce54d4x5t"
      ]
    }
  },
  "next_cursor": null,
  "data": [
   {
     "app_store_identifier": "com.twitter.android",
     "conversion_tracking_enabled": false,
     "deep_link_pattern": "twitter://",
     "id": "4x",
     "created_at": "2019-06-20T22:36:16Z",
     "updated_at": "2021-10-19T20:05:29Z",
     "os_type": "Android",
     "deleted": false
   }
  ]
}
```

--------------------------------

### GET Account Apps Request

Source: https://docs.x.com/x-ads-api/campaign-management/reference

This is an example of a GET request to retrieve all mobile apps associated with a specific ad account.

```HTTP
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/account_apps
```

--------------------------------

### Create Manual Product Set

Source: https://docs.x.com/x-ads-api/catalog-management/reference

Use this to create a product set by manually specifying product keys. Ensure the 'type' is set to 'MANUAL' and 'product_keys' are provided.

```json
POST https://ads-api.x.com/12/product_catalogs/1569782857975087104/product_sets

{
  "name": "manual API product set",
  "type": "MANUAL",
  "product_keys": [
    "1569784751351013380"
  ]
}
```

--------------------------------

### Campaign Launch Response Example

Source: https://docs.x.com/x-ads-api/campaign-management

This is an example response for launching a campaign, showing the updated campaign details including its active status.

```json
{
  "request": {
    "params": {
      "campaign_id": "f2rp3",
      "account_id": "55w3kv"
    }
  },
  "data": {
    "name": "test-curated-categories-api",
    "start_time": "2021-02-10T00:00:00Z",
    "reasons_not_servable": [
    ],
    "servable": false,
    "purchase_order_number": null,
    "effective_status": "ACTIVE",
    "daily_budget_amount_local_micro": 55000000,
    "end_time": null,
    "funding_instrument_id": "103hp9",
    "duration_in_days": null,
    "standard_delivery": true,
    "total_budget_amount_local_micro": null,
    "id": "f2rp3",
    "entity_status": "ACTIVE",
    "frequency_cap": null,
    "currency": "USD",
    "created_at": "2021-02-08T23:55:38Z",
    "updated_at": "2021-02-08T23:55:38Z",
    "deleted": false
  }
}
```

--------------------------------

### Example Response for Media Library Upload

Source: https://docs.x.com/x-ads-api/creatives/reference

This is an example response after successfully uploading a media asset to the library. It includes details about the media's status, type, and URLs.

```JSON
{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "media_key": "3_931236738554519552"
    }
  },
  "data": {
    "tweeted": false,
    "name": null,
    "file_name": null,
    "media_url": "https://pbs.twimg.com/media/DOxq4TtV4AAlvh_.jpg",
    "media_category": "TWEET_IMAGE",
    "media_key": "3_931236738554519552",
    "created_at": "2017-11-16T19:05:14Z",
    "media_status": "TRANSCODE_COMPLETED",
    "media_type": "IMAGE",
    "updated_at": "2017-11-16T19:05:23Z",
    "deleted": false
  }
}
```

--------------------------------

### Example Response for Retrieving Product Catalogs

Source: https://docs.x.com/x-ads-api/catalog-management/reference

Illustrates the structure of the response when retrieving product catalog details, including catalog IDs and names.

```json
{
  "request": {
    "params": {}
  },
  "next_cursor": null,
  "data": [
    {
      "id": "1547080201384865792",
      "name": "Catalog Name"
    }
  ]
}
```

--------------------------------

### GET accounts/:account_id/tweets Example Response

Source: https://docs.x.com/x-ads-api/creatives/reference

Example JSON response for a request to retrieve tweet details, including request parameters and tweet data.

```JSON
{
  "request": {
    "params": {
      "tweet_ids": [
        "1166476031668015104"
      ],
      "tweet_type": "PUBLISHED",
      "trim_user": true,
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "coordinates": null,
      "retweeted": false,
      "name": null,
      "source": "<a href=\"https://ads-api.x.com\" rel=\"nofollow\">Ads API Internal Test App</a>",
      "entities": {
        "hashtags": [],
        "symbols": [],
        "user_mentions": [],
        "urls": []
      },
      "display_text_range": [
        0,
        9
      ],
      "favorite_count": 0,
      "in_reply_to_status_id_str": null,
      "geo": null,
      "id_str": "1166476031668015104",
      "scopes": {
        "followers": false
      },
      "in_reply_to_user_id": null,
      "truncated": false,
      "retweet_count": 0,
      "id": 1166476031668015104,
      "in_reply_to_status_id": null,
      "conversation_settings": "EVERYONE",
      "nullcast": true,
      "created_at": "Tue Aug 27 22:22:12 +0000 2019",
      "place": null,
      "scheduled_at": null,
      "tweet_type": "PUBLISHED",
      "favorited": false,
      "full_text": "hello, v6",
      "lang": "es",
      "contributors": [
        2417045708
      ],
      "in_reply_to_screen_name": null,
      "in_reply_to_user_id_str": null,
      "user": {
        "id": 756201191646691328,
        "id_str": "756201191646691328"
      },
      "tweet_id": "1166476031668015104"
    }
  ]
}
```

--------------------------------

### Content Categories Response Example

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example response for the GET content_categories endpoint, showing category names, IDs, associated IAB categories, and monetization statistics.

```JSON
{
  "request": {
    "params": {}
  },
  "next_cursor": null,
  "data": [
    {
      "name": "Automotive (Cars, Trucks, Racing)",
      "id": "ru",
      "iab_categories": [
        "IAB2"
      ],
      "publishers_in_last_thirty_days": 12,
      "videos_monetized_in_last_thirty_days": 316
    },
    {
      "name": "Comedy",
      "id": "sk",
      "iab_categories": [
        "IAB1-4"
      ],
      "publishers_in_last_thirty_days": 19,
      "videos_monetized_in_last_thirty_days": 174
    },
    {
      "name": "Digital Creators",
      "id": "sl",
      "iab_categories": [
        "IAB25-1"
      ],
      "publishers_in_last_thirty_days": 110,
      "videos_monetized_in_last_thirty_days": 1257
    },
    {
      "name": "Entertainment & Pop Culture",
      "id": "sm",
      "iab_categories": [
        "IAB1-1",
        "IAB1-2",
        "IAB1-3",
        "IAB1-5"
      ],
      "publishers_in_last_thirty_days": 120,
      "videos_monetized_in_last_thirty_days": 3482
    },
    {
      "name": "Financial & Business News",
      "id": "sn",
      "iab_categories": [
        "IAB3",
        "IAB13",
        "IAB21"
      ],
      "publishers_in_last_thirty_days": 29,
      "videos_monetized_in_last_thirty_days": 1461
    },
    {
      "name": "Food & Drink",
      "id": "so",
      "iab_categories": [
        "IAB8-8",
        "IAB8-12",
        "IAB8-17",
        "IAB8-2",
        "IAB8-3",
        "IAB8-7",
        "IAB8-11",
        "IAB8-4",
        "IAB8-14",
        "IAB8-10",
        "IAB8-15",
        "IAB8-13",
        "IAB8-9",
        "IAB8-16",
        "IAB8-6",
        "IAB8-1"
      ],
      "publishers_in_last_thirty_days": 24,
      "videos_monetized_in_last_thirty_days": 516
    },
    {
      "name": "Lifestyle (Fashion, Travel, Wellness)",
      "id": "sp",
      "iab_categories": [
        "IAB16",
        "IAB9-21",
        "IAB9-4",
        "IAB9-25",
        "IAB9-8",
        "IAB4",
        "IAB9-3",
        "IAB9-15",
        "IAB7",
        "IAB6",
        "IAB9-11",
        "IAB9-16",
        "IAB9-7",
        "IAB9-20",
        "IAB9-24",
        "IAB9-17",
        "IAB9-12",
        "IAB9-31",
        "IAB9-27",
        "IAB10",
        "IAB9-10",
        "IAB9-23",
        "IAB9-6",
        "IAB9-18",
        "IAB9-13",
        "IAB9-1",
        "IAB9-28",
        "IAB20",
        "IAB9-5",
        "IAB9-26",
        "IAB22",
        "IAB23",
        "IAB9-9",
        "IAB9-22",
        "IAB18",
        "IAB9-2",
        "IAB9-19",
        "IAB9-14",
        "IAB9-29"
      ],
      "publishers_in_last_thirty_days": 67,
      "videos_monetized_in_last_thirty_days": 2412
    },
    {
      "name": "Music",
      "id": "sq",
      "iab_categories": [
        "IAB1-6"
      ],
      "publishers_in_last_thirty_days": 31,
      "videos_monetized_in_last_thirty_days": 518
    },
    {
      "name": "News & Current Events",
      "id": "sr",
      "iab_categories": [
        "IAB12",
        "IAB14"
      ],
      "publishers_in_last_thirty_days": 125,
      "videos_monetized_in_last_thirty_days": 5507
    },
    {
      "name": "Politics",
      "id": "s4",
      "iab_categories": [
        "IAB11"
      ],

```

--------------------------------

### GET App Event Tags Request

Source: https://docs.x.com/x-ads-api/measurement/mobile-conversions

Example of a GET request to retrieve app event tags for a specific account, with filtering by app event tag IDs.

```HTTP
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags?app_event_tag_ids=jhp
```

--------------------------------

### Promoted Accounts Response Example

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example JSON response when retrieving a list of promoted accounts. Includes request parameters, pagination details, and a list of promoted account data objects.

```JSON
{
  "request": {
    "params": {
      "promoted_account_ids": [
        "19pl2"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "line_item_id": "9bpb2",
      "user_id": "756201191646691328",
      "id": "19pl2",
      "entity_status": "ACTIVE",
      "created_at": "2017-07-05T05:54:13Z",
      "updated_at": "2017-07-05T05:54:13Z",
      "approval_status": "ACCEPTED",
      "deleted": false
    }
  ]
}
```

--------------------------------

### GET accounts/:account_id/account_history Request

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example GET request to retrieve account history for a specific campaign. Ensure the account ID, entity type, entity ID, and count are correctly specified.

```bash
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/account_history?entity_type=CAMPAIGN&entity_id=fc3h5&count=1
```

--------------------------------

### Create Campaign

Source: https://docs.x.com/x-ads-api/campaign-management

Create a new campaign with a specified name, budget, and start time. Ensure the objective is VIDEO_VIEWS_PREROLL and product_type is MEDIA. The categories parameter must be set.

```json
POST https://ads-api.x.com/8/accounts/55w3kv/campaigns?name=test-curated-categories-api&funding_instrument_id=103hp9&start_time=2021-02-10&entity_status=PAUSED&daily_budget_amount_local_micro=55000000

{
  "request": {
    "params": {
      "name": "test-curated-categories-api",
      "start_time": "2021-02-10T00:00:00Z",
      "daily_budget_amount_local_micro": 55000000,
      "funding_instrument_id": "103hp9",
      "entity_status": "PAUSED",
      "account_id": "55w3kv"
    }
  },
  "data": {
    "name": "test-curated-categories-api",
    "start_time": "2021-02-10T00:00:00Z",
    "reasons_not_servable": [
      "EXPIRED",
      "PAUSED_BY_ADVERTISER",
      "FUNDING_PROBLEM"
    ],
    "servable": false,
    "purchase_order_number": null,
    "effective_status": "PAUSED",
    "daily_budget_amount_local_micro": 55000000,
    "end_time": null,
    "funding_instrument_id": "103hp9",
    "duration_in_days": null,
    "standard_delivery": true,
    "total_budget_amount_local_micro": null,
    "id": "f2rp3",
    "entity_status": "PAUSED",
    "frequency_cap": null,
    "currency": "USD",
    "created_at": "2021-02-08T23:55:38Z",
    "updated_at": "2021-02-08T23:55:38Z",
    "deleted": false
  }
}
```

--------------------------------

### Example Response for Media Library Objects

Source: https://docs.x.com/x-ads-api/creatives/reference

Illustrates the structure of a successful response when retrieving media library objects, including request parameters and a list of media data.

```JSON
{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t",
      "count": 1
    }
  },
  "data": [
    {
      "tweeted": true,
      "name": null,
      "file_name": "coffee https://t.co/4tcPU9XUon",
      "media_url": "https://pbs.twimg.com/media/DJvnJf_UEAAXnzC.jpg",
      "media_category": "TWEET_IMAGE",
      "media_key": "3_908573900237180928",
      "created_at": "2017-09-15T06:11:12Z",
      "media_status": "TRANSCODE_COMPLETED",
      "media_type": "IMAGE",
      "updated_at": "2017-11-16T06:00:01Z",
      "deleted": false
    }
  ],
  "next_cursor": "c-1"
}
```

--------------------------------

### Get Curated Categories

Source: https://docs.x.com/x-ads-api/campaign-management

Fetch curated categories for a specific account. This is often used in campaign setup.

```bash
GET accounts/:account_id/curated_categories
```

--------------------------------

### App Carousel JSON POST Body Example

Source: https://docs.x.com/x-ads-api/creatives

This example shows the complete JSON POST body for creating a carousel ad that encourages app installs. It uses the SWIPEABLE_MEDIA and BUTTON components with app destination details.

```json
{
  "name": "app carousel",
  "components": [
    {
      "type": "SWIPEABLE_MEDIA",
      "media_keys": [
        "13_1089771253848666112",
        "13_1191948012077092867"
      ]
    },
    {
      "type": "BUTTON",
      "label": {
        "type": "ENUM",
        "value": "INSTALL"
      },
      "destination": {
        "type": "APP",
        "country_code": "US",
        "googleplay_app_id": "com.twitter.android",
        "iphone_app_id": "333903271"
      }
    }
  ]
}
```

--------------------------------

### Specific Promoted Account Response Example

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example JSON response when retrieving details for a single promoted account. Includes request parameters and the promoted account data object.

```JSON
{
  "request": {
    "params": {
      "promoted_account_id": "19pl2",
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "line_item_id": "9bpb2",
    "user_id": "756201191646691328",
    "id": "19pl2",
    "entity_status": "ACTIVE",
    "created_at": "2017-07-05T05:54:13Z",
    "updated_at": "2017-07-05T05:54:13Z",
    "approval_status": "ACCEPTED",
    "deleted": false
  }
}
```

--------------------------------

### Get Specific Account Response

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example response structure for a single account. It includes request parameters and detailed data for the specified account.

```json
{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "name": "API McTestface",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-07-21T07:00:00Z",
    "id": "18ce54d4x5t",
    "created_at": "2016-07-21T22:42:09Z",
    "updated_at": "2017-07-06T16:51:04Z",
    "industry_type": "TRAVEL",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
  }
}
```

--------------------------------

### Example Card Creation Response

Source: https://docs.x.com/x-ads-api/creatives/reference

This is an example response from a card creation request, detailing the created card's components, IDs, and timestamps.

```json
{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "name": "components create cards",
    "components": [
      {
        "type": "MEDIA",
        "media_key": "3_1323490622599176192"
      },
      {
        "type": "BUTTON",
        "label": {
          "type": "ENUM",
          "value": "INSTALL"
        },
        "destination": {
          "type": "APP",
          "country_code": "US",
          "googleplay_app_id": "com.twitter.android"
        }
      }
    ],
    "created_at": "2020-11-11T05:42:25Z",
    "card_uri": "card://132399865065238531",
    "id": "1321554298900107264",
    "updated_at": "2020-11-11T05:42:25Z",
    "deleted": false,
    "card_type": "IMAGE_APP"
  }
}

```

--------------------------------

### Get All Accounts Response

Source: https://docs.x.com/x-ads-api/campaign-management/reference

Example response structure when retrieving account details. It includes request parameters and a list of account data objects.

```json
{
  "request": {
    "params": {
      "account_ids": [
        "18ce54d4x5t"
      ]
    }
  },
  "next_cursor": null,
  "data": [
    {
      "name": "API McTestface",
      "business_name": null,
      "timezone": "America/Los_Angeles",
      "timezone_switch_at": "2016-07-21T07:00:00Z",
      "id": "18ce54d4x5t",
      "created_at": "2016-07-21T22:42:09Z",
      "updated_at": "2017-07-06T16:51:04Z",
      "business_id": null,
      "approval_status": "ACCEPTED",
      "deleted": false
    }
  ]
}
```

--------------------------------

### App Event Tags Response

Source: https://docs.x.com/x-ads-api/measurement/mobile-conversions

Example JSON response for a request to retrieve app event tags, including details about the conversion tracking setup.

```JSON
{
  "request": {
    "params": {
      "app_event_tag_ids": [
        "jhp"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "provider_app_event_name": null,
      "app_store_identifier": "co.vine.android",
      "post_view_attribution_window": 1,
      "deep_link_scheme": "vine://",
      "id": "jhp",
      "retargeting_enabled": true,
      "conversion_type": "INSTALL",
      "created_at": "2016-12-08T07:49:58Z",
      "post_engagement_attribution_window": 14,
      "provider_app_event_id": null,
      "last_tracked_at": "2021-05-22T17:00:04Z",
      "status": "TRACKING",
      "updated_at": "2016-12-08T23:07:54Z",
      "os_type": "ANDROID",
      "deleted": false
    }
  ]
}
```

--------------------------------

### GET accounts/:account_id/cards/image_conversation Response

Source: https://docs.x.com/x-ads-api/creatives/reference

Example response structure for retrieving image conversation cards. Includes request parameters and a list of card data objects.

```json
{
  "request": {
    "params": {
      "card_type": "image_conversation",
      "card_ids": [
        "59woh"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "name": "image conversation card",
      "first_cta": "#moon",
      "image_display_height": "670",
      "media_url": "https://pbs.twimg.com/media/DUhZuzxUQAAWZqr.jpg",
      "thank_you_text": "thanks",
      "id": "59woh",
      "first_cta_tweet": "stars",
      "media_key": "3_957113581522141184",
      "created_at": "2018-01-27T04:58:42Z",
      "image_display_width": "1280",
      "card_uri": "card://923498485702009837",
      "title": "Full moon",
      "updated_at": "2018-01-27T04:58:42Z",
      "deleted": false,
      "card_type": "IMAGE_CONVERSATION"
    }
  ]
}
```

--------------------------------

### Example GET Request for Reach Statistics

Source: https://docs.x.com/x-ads-api/analytics

This example demonstrates how to request reach statistics for a specific account and funding instrument within a given time range. Ensure the account ID and funding instrument ID are valid and associated with your account. The time range is limited to a maximum of 7 days.

```http
GET https://ads-api.x.com/12/stats/accounts/18ce54d4x5t/reach/funding_instruments?funding_instrument_ids=lygyi&start_time=2017-05-19&end_time=2017-05-26
```