Get Started
API Endpoints
- Ayrshare API Overview
- Ads
- Analytics
- Auto Schedule
- Brand
- Comments
- Feed
- Generate
- Hashtags
- History
- Links
- Media
- Messages
- Post
- Profiles
- Reviews
- User
- Utils
- Validate
- Webhooks
Multiple Users
Dashboard
- Overview
- Connect Social Accounts
- Publish a Post
- Revoke Access to Social Media
- RSS
Additional
- What's New At Ayrshare
- Errors
- Max Pack
- Media Guidelines
- Packages & Guides
- System Status
- Testing & Verification
- ISO Codes
Groups
The Ad Groups are the groupings under a given Campaign.
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
{
"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
}
]
}
{
"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
}
]
}