API Reference

Update a media property

Updates the specified media property's attributes by setting the values of the parameters passed in the request. Any parameter not provided will leave the corresponding attribute unchanged. Submitted parameter values will overwrite an attribute's existing value entirely—for attributes like RevenueModel, you must submit both the new value and the existing value if you want that attribute to reflect both.

Parameters

Name optional

The name of the media property.

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(s) for your media property.

Possible enum values
PAY_PER_LEAD
PAY_PER_INQUIRY
PAY_PER_SALE
PAY_PER_CLICK
PAY_PER_INSTALL

Url optional

The public URL to view this media property.

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.

MobilePlatform optional for mobile media properties

For mobile app media properties, the mobile platform the app is on.

Possible enum values
IOS
ANDROID

AppStoreRating optional for mobile media properties

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

Price optional for mobile media properties

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

Installs optional 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 optional 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 optional 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

Handle optional for social media properties

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

Returns

The status of the request and the URI to view the updated media property. Returns an error if any update parameters are invalid or if the media property does not exist.

Example request

curl 'https://api.impact.com/Mediapartners/<AccountSID>/MediaProperties/1234567' \
  -X PUT \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: multipart/form-data' \
  -d 'Name=CoyoteApp 2.0' \
  -d 'Url=https://www.example.com/downloadCoyoteApp' \
  -d 'Description=CoyoteApp 2.0 is the latest in mobile entertainment!' \
  -d 'Thumbnail=image.png' \
  -d 'image.png=@"/local/path/to/an/image.png"' \
  -d 'Tags=mobile,gaming,shopping' \
  -d 'Installs=MILLION_PLUS' \
  -d 'MobilePlatform=IOS"

Example response

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