List Campaign Ads

GET

/ad-campaigns/{campaign_id}/ads

• Production
• QA

List the ads in a campaign.

Always a collection. A campaign launched before per-ad control existed returns its single implicit ad, promoted to a real slot on first read so the caller receives a stable id it can act on.

Authorizations

• BearerAuth

Parameters

Path Parameters

campaign_id

required

Ad campaign ID

integer

Ad campaign ID

Query Parameters

include_archived

boolean

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

object

ads

required

Array<object>

One ad inside a campaign — a creative slot.

id is graph8’s, and it is stable: editing an ad almost always mints a new platform ad (LinkedIn creatives are immutable, and on Google only Search/RSA is mutable in place), but the slot and its measurement history survive that. Address an ad by this id, never by platform_ad_id.

object

ad_group_id

Any of:

integer

integer

null

null

ad_group_name

Any of:

string

string

null

null

approval_nuance

Any of:

string

string

null

null

campaign_id

required

integer

copy_assets

Any of:

object

object

key

additional properties

any

null

null

created_at

Any of:

string

string

null

null

creative_image_url

Any of:

string

string

null

null

creative_image_url_portrait

Any of:

string

string

null

null

creative_image_url_square

Any of:

string

string

null

null

cta

Any of:

string

string

null

null

description

Any of:

string

string

null

null

destination_url

Any of:

string

string

null

null

error_message

Any of:

string

string

null

null

headline

Any of:

string

string

null

null

id

Any of:

integer

integer

null

null

launched_at

Any of:

string

string

null

null

logo_image_url

Any of:

string

string

null

null

name

Any of:

string

string

null

null

platform_ad_id

Any of:

string

string

null

null

policy_topics

Any of:

Array<object>

Array<object>

object

key

additional properties

any

null

null

primary_text

Any of:

string

string

null

null

slot_index

required

integer

source_ad_creative_id

Any of:

string

string

null

null

status

required

Draft | launching | active | paused | archived | failed

string

campaign_id

required

integer

count

required

integer

platform

Any of:

string

string

null

null

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string