Skip to end of metadata
Go to start of metadata

Creative Search Service

This read-only service allows you to search for active creatives based on specific criteria, such as audit status, ID, size, etc. You may then wish to use these creative IDs in the Ad Profile Service. To add creatives to the system, see the Creative Service.

Since this service searches all active creatives on the AppNexus platform (not just your own), a search that is too broad might cause an error. To ensure that you get results, please narrow your search as much as possible.

REST API

Search for creatives:

Search for creatives and sort results:

The fields used to search for creatives are not exactly the same as the fields returned. This is because the returned objects are drawn from the Creative Service and formatted accordingly.

JSON Fields

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Field

Type

Sort?

Use

creative_ids

array of integers

Yes, use "id" in query string.

Search for creatives by their IDs. 

description

string

No

Search for creatives by terms in their descriptions.

audit_status

array of enums

Yes

Search for creatives by their audit status. Possible values: "no_audit", "pending", "rejected", "audited".

ad_profile_id

int

No

Must be used with brand_status. Search for a creative by the ID of its ad profile.

brand_status

array of enums

No

Must be used with ad_profile_id. Search for creatives by their brand status. For example, if this is set to "trusted", all trusted brands within the ad profiles specified in ad_profile_id will be returned in the response. Possible values: "trusted", "case-by-case", "banned". The brand status field is only returned in the response when you use this filter.

review_status

array of enums

No

Search for creatives based on their review status (from the associated ad profiles). Possible values: "reviewed", "unreviewed". The review status field is only returned in the response when you use this filter.

uploaded_since

timestamp

No

Search for creatives that were uploaded since this date. Format: "YYYY-MM-DD HH:MM:SS".

modified_since

timestamp

No

Search for creatives that were modified since this date. Format: "YYYY-MM-DD HH:MM:SS".

formats

array of enums

Yes, use "format" in query string.

Search for creatives by their formats. Possible values: "url-html", "url-js", "flash", "image", "raw-js", "raw-html", "iframe-html", "url-vast", "text".

media_subtype

array of enums

No

Deprecated, use media_subtype_ids instead. Search for creatives by their media subtypes. Possible values: "Banner", "Popup", "Popunder".

media_subtype_ids

array of integers

Yes, use "media_subtype_id" in query string.

Search for creatives by their media subtype via ID. You can use the Media Subtype Service to look up the desired ID's.

media_url

string

Yes

Search for a creative by its URL.

media_content

string

No

Search for a creative by the data in its original_content field (see Creative Service).

sizes

array of strings

Yes, use "width" and "height" in query string.

Search for creatives by their sizes, for example, "728x90".

brand_ids

array of integers

No

Search for creatives by the IDs of their brands.

member_ids

array of integers

Yes, use "member_id" in query string.

Must be used with member_action. Search for creatives by the IDs of their members.

member_action

enum

No

Must be used with member_ids. If this is set to "exclude", you exclude the members specified in member_ids from the search. Otherwise, the specified IDs are included.

template_id

int

Yes

Search for creatives by their creative template IDs.

size_in_bytes

string

Yes

Not a filter. Sort results in ascending/descending size order.

click_url

string

Yes

Not a filter. Sort results in ascending/descending alphabetical click URL order.

landing_page_url

string

Yes

Not a filter. Sort results in ascending/descending alphabetical landing page URL order.

Examples

 Search for all banner creatives that have passed AppNexus audit
 Search for all flash creatives that have been uploaded since 2012-01-01 00:00:00
 Search for all 728x90 and 300x250 image creatives that belong to member 333