API Reference

Create a media property

Creates a new media property object. New media properties need to be verified by impact.com before they're fully approved.

Parameters

Name required

The name of the media property.

Type required

The type of this media property.

Possible enum values
WEBSITE
MOBILE
SOCIAL

Url required

The URL to this media property.

MobilePlatform required only for mobile media properties

Possible enum values
IOS
ANDROID

AppStoreRating required only for mobile media properties

The approximate rating for your mobile media property—round to the nearest whole number (from 1–5).

Installs required only for mobile media properties

The approximate number of accumulated installs for your mobile media property.

Possible enum values
HUNDRED_PLUS
THOUSAND_PLUS
TEN_THOUSAND_PLUS
HUNDRED_THOUSAND_PLUS
MILLION_PLUS
TEN_MILLION_PLUS
HUNDRED_MILLION_PLUS

SocialPlatform required only for social media properties

The platform your social media property is on.

Possible enum values
FACEBOOK
X/TWITTER
INSTAGRAM
PINTEREST
YOUTUBE
TIKTOK
LINKEDIN
WECHAT
WEIBO
TWITCH

Followers required only for social media properties

The approximate amount of followers your social media property has.

Possible enum values
HUNDRED_PLUS
THOUSAND_PLUS
TEN_THOUSAND_PLUS
HUNDRED_THOUSAND_PLUS
MILLION_PLUS
TEN_MILLION_PLUS
HUNDRED_MILLION_PLUS

Thumbnail optional

A thumbnail image for your media property. Including this parameter requires the header Content-Type: multipart/form-data and specifying the location to the image file on your local computer that you want to upload. See the cURL example.

Description optional

A brief description of your media property.

Tags optional

Tags for your media property—brands can see these when discovering new partners in impact.com.

RevenueModel optional

The preferred revenue model for your media property.

Possible enum values
PAY_PER_LEAD
PAY_PER_INQUIRY
PAY_PER_SALE
PAY_PER_CLICK
PAY_PER_INSTALL

MonthlyUniqueVisitors optional for website media properties

The approximate amount of monthly unique visitors for your website media property, expressed as an integer.

AlexaRating optional for website media properties

The approximate Alexa ranking for your website media property, expressed as an integer.

QuantcastRating optional for website media properties

The approximate Quantcast rating for your website media property, expressed as an integer.

Price optional for mobile media properties

For mobile media properties, the price charged to download the app.

Handle optional for social media properties

For social media properties, the handle (i.e., username) for your account.

Returns

Returns the status of the request and the URI of the newly created media property. Returns an error if create parameters are invalid or if a required parameter is missing.

Example request

curl 'https://api.impact.com/Mediapartners/<AccountSID>/MediaProperties' \
  -X POST \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: multipart/form-data' \
  -d 'Name=Wile E. Coyote\'s website' \
  -d 'Type=WEBSITE' \
  -d 'Url=https://www.example.com' \
  -d 'Description=The official website for Wile E. Coyote.' \
  -d 'Thumbnail=image.png' \
  -d 'image.png=@"/local/path/to/an/image.png"' \
  -d 'Tags=website,blog,content' \
  -d 'MonthlyUniqueVisitors=10000' \
  -d 'RevenueModel=PAY_PER_SALE'

Example response

{
  "Status": "OK",
  "Uri": "/Mediapartners/<AccountSID>/MediaProperties/<Id>"
}