GET
/
ads
/
twitter
/
groups
{
    "id": "18ca55appc1",
    "groups": [
        {
            "advertiser_user_id": 912598959413241900,
            "name": "ad-group-1",
            "placements": [
                "TWITTER_TIMELINE"
            ],
            "start_time": null,
            "bid_amount_local_micro": 1500000,
            "automatically_select_bid": false,
            "advertiser_domain": null,
            "target_cpa_local_micro": null,
            "primary_web_event_tag": null,
            "goal": "LINK_CLICKS",
            "product_type": "PROMOTED_TWEETS",
            "end_time": null,
            "bid_strategy": "TARGET",
            "duration_in_days": null,
            "total_budget_amount_local_micro": null,
            "objective": "WEBSITE_CLICKS",
            "id": "it6bm",
            "entity_status": "ACTIVE",
            "automatic_tweet_promotion": null,
            "frequency_cap": null,
            "android_app_store_identifier": null,
            "categories": [],
            "currency": "USD",
            "pay_by": "LINK_CLICK",
            "created_at": "2021-02-19T23:49:29Z",
            "tracking_tags": [],
            "ios_app_store_identifier": null,
            "updated_at": "2021-02-19T23:56:47Z",
            "campaign_id": "f4o5v",
            "creative_source": "MANUAL",
            "deleted": false
        },
        {
            "advertiser_user_id": 915598958418221000,
            "name": "Social Media More Followers",
            "placements": [
                "ALL_ON_TWITTER"
            ],
            "start_time": null,
            "bid_amount_local_micro": 2250000,
            "automatically_select_bid": false,
            "advertiser_domain": null,
            "target_cpa_local_micro": null,
            "primary_web_event_tag": null,
            "goal": "FOLLOWERS",
            "product_type": "PROMOTED_ACCOUNT",
            "end_time": null,
            "bid_strategy": "TARGET",
            "duration_in_days": null,
            "total_budget_amount_local_micro": null,
            "objective": "FOLLOWERS",
            "id": "iucoy",
            "entity_status": "PAUSED",
            "automatic_tweet_promotion": null,
            "frequency_cap": null,
            "android_app_store_identifier": null,
            "categories": [],
            "currency": "USD",
            "pay_by": "FOLLOW",
            "created_at": "2021-02-25T20:01:14Z",
            "tracking_tags": [],
            "ios_app_store_identifier": null,
            "updated_at": "2021-04-27T16:18:41Z",
            "campaign_id": "f2cf2",
            "creative_source": "MANUAL",
            "deleted": false
        },
        {
            "advertiser_user_id": 915598979413291000,
            "name": "Ads Api Test Group Name",
            "placements": [
                "PUBLISHER_NETWORK",
                "ALL_ON_TWITTER"
            ],
            "start_time": null,
            "bid_amount_local_micro": null,
            "automatically_select_bid": true,
            "advertiser_domain": "ayrshare.com",
            "target_cpa_local_micro": null,
            "primary_web_event_tag": null,
            "goal": "LINK_CLICKS",
            "product_type": "PROMOTED_TWEETS",
            "end_time": null,
            "bid_strategy": "AUTO",
            "duration_in_days": null,
            "total_budget_amount_local_micro": null,
            "objective": "WEBSITE_CLICKS",
            "id": "j2gao",
            "entity_status": "PAUSED",
            "automatic_tweet_promotion": null,
            "frequency_cap": null,
            "android_app_store_identifier": null,
            "categories": [
                "IAB19"
            ],
            "currency": "USD",
            "pay_by": "LINK_CLICK",
            "created_at": "2021-03-31T01:50:19Z",
            "tracking_tags": [],
            "ios_app_store_identifier": null,
            "updated_at": "2021-03-31T02:07:20Z",
            "campaign_id": "fbpyf",
            "creative_source": "MANUAL",
            "deleted": false
        }
    ]
}

The Ad Groups are the groupings under a given Campaign. The id of an array element is the key information needed for the promote Tweet.

Note: Twitter sometimes refers to groups as line items.

Header Parameters

Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY
{
    "id": "18ca55appc1",
    "groups": [
        {
            "advertiser_user_id": 912598959413241900,
            "name": "ad-group-1",
            "placements": [
                "TWITTER_TIMELINE"
            ],
            "start_time": null,
            "bid_amount_local_micro": 1500000,
            "automatically_select_bid": false,
            "advertiser_domain": null,
            "target_cpa_local_micro": null,
            "primary_web_event_tag": null,
            "goal": "LINK_CLICKS",
            "product_type": "PROMOTED_TWEETS",
            "end_time": null,
            "bid_strategy": "TARGET",
            "duration_in_days": null,
            "total_budget_amount_local_micro": null,
            "objective": "WEBSITE_CLICKS",
            "id": "it6bm",
            "entity_status": "ACTIVE",
            "automatic_tweet_promotion": null,
            "frequency_cap": null,
            "android_app_store_identifier": null,
            "categories": [],
            "currency": "USD",
            "pay_by": "LINK_CLICK",
            "created_at": "2021-02-19T23:49:29Z",
            "tracking_tags": [],
            "ios_app_store_identifier": null,
            "updated_at": "2021-02-19T23:56:47Z",
            "campaign_id": "f4o5v",
            "creative_source": "MANUAL",
            "deleted": false
        },
        {
            "advertiser_user_id": 915598958418221000,
            "name": "Social Media More Followers",
            "placements": [
                "ALL_ON_TWITTER"
            ],
            "start_time": null,
            "bid_amount_local_micro": 2250000,
            "automatically_select_bid": false,
            "advertiser_domain": null,
            "target_cpa_local_micro": null,
            "primary_web_event_tag": null,
            "goal": "FOLLOWERS",
            "product_type": "PROMOTED_ACCOUNT",
            "end_time": null,
            "bid_strategy": "TARGET",
            "duration_in_days": null,
            "total_budget_amount_local_micro": null,
            "objective": "FOLLOWERS",
            "id": "iucoy",
            "entity_status": "PAUSED",
            "automatic_tweet_promotion": null,
            "frequency_cap": null,
            "android_app_store_identifier": null,
            "categories": [],
            "currency": "USD",
            "pay_by": "FOLLOW",
            "created_at": "2021-02-25T20:01:14Z",
            "tracking_tags": [],
            "ios_app_store_identifier": null,
            "updated_at": "2021-04-27T16:18:41Z",
            "campaign_id": "f2cf2",
            "creative_source": "MANUAL",
            "deleted": false
        },
        {
            "advertiser_user_id": 915598979413291000,
            "name": "Ads Api Test Group Name",
            "placements": [
                "PUBLISHER_NETWORK",
                "ALL_ON_TWITTER"
            ],
            "start_time": null,
            "bid_amount_local_micro": null,
            "automatically_select_bid": true,
            "advertiser_domain": "ayrshare.com",
            "target_cpa_local_micro": null,
            "primary_web_event_tag": null,
            "goal": "LINK_CLICKS",
            "product_type": "PROMOTED_TWEETS",
            "end_time": null,
            "bid_strategy": "AUTO",
            "duration_in_days": null,
            "total_budget_amount_local_micro": null,
            "objective": "WEBSITE_CLICKS",
            "id": "j2gao",
            "entity_status": "PAUSED",
            "automatic_tweet_promotion": null,
            "frequency_cap": null,
            "android_app_store_identifier": null,
            "categories": [
                "IAB19"
            ],
            "currency": "USD",
            "pay_by": "LINK_CLICK",
            "created_at": "2021-03-31T01:50:19Z",
            "tracking_tags": [],
            "ios_app_store_identifier": null,
            "updated_at": "2021-03-31T02:07:20Z",
            "campaign_id": "fbpyf",
            "creative_source": "MANUAL",
            "deleted": false
        }
    ]
}