# MediaProperties
## List all media properties
> Lists all media properties for your account.
```json
{"openapi":"3.1.0","info":{"title":"Partner Media Properties API","version":"14"},"tags":[{"name":"Media Properties","description":"Endpoints for listing, creating, retrieving, updating, and deleting partner media properties."}],"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"parameters":{"AccountSID":{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."}},"schemas":{"MediaProperty":{"type":"object","properties":{"Id":{"type":"string","description":"Unique identifier for the media property."},"Name":{"type":"string","description":"Display name of the media property."},"Thumbnail":{"type":"string","description":"API resource path to the thumbnail image for this media property, if one has been uploaded."},"Description":{"type":"string","description":"A description of the media property and its audience."},"Tags":{"type":"string","description":"Comma-separated tags used to categorize this media property."},"RevenueModel":{"type":"array","description":"The monetization model(s) used by this media property.","items":{"$ref":"#/components/schemas/RevenueModel"}},"Url":{"type":"string","description":"The URL of the media property."},"Type":{"$ref":"#/components/schemas/PropertyType","description":"The type of media property."},"MonthlyUniqueVisitors":{"type":"string","description":"Estimated monthly unique visitors. Applies to WEBSITE type properties."},"AlexaRating":{"type":"string","description":"Alexa global traffic rank for this media property. Applies to WEBSITE type properties."},"QuantcastRating":{"type":"string","description":"Quantcast audience measurement rating. Applies to WEBSITE type properties."},"OwnershipVerified":{"type":"string","description":"Indicates whether ownership of this media property has been verified by impact.com."},"MobilePlatform":{"$ref":"#/components/schemas/MobilePlatform","description":"The mobile platform this app is published on. Applies to MOBILE type properties."},"AppStoreRating":{"type":"string","description":"App store rating out of 5. Applies to MOBILE type properties."},"Installs":{"$ref":"#/components/schemas/InstallsFollowers","description":"Estimated number of installs. Applies to MOBILE type properties."},"Price":{"type":"string","description":"The price of the app in the app store. Applies to MOBILE type properties."},"SocialPlatform":{"$ref":"#/components/schemas/SocialPlatform","description":"The social media platform this property is on. Applies to SOCIAL type properties."},"Followers":{"$ref":"#/components/schemas/InstallsFollowers","description":"Estimated number of followers or subscribers. Applies to SOCIAL type properties."},"Handle":{"type":"string","description":"The social media handle or username for this property. Applies to SOCIAL type properties."},"Uri":{"type":"string","description":"Unique reference to this media property in the impact.com API."}}},"RevenueModel":{"type":"string","description":"The monetization model used by a media property.","enum":["PAY_PER_LEAD","PAY_PER_INQUIRY","PAY_PER_SALE","PAY_PER_CLICK","PAY_PER_INSTALL"]},"PropertyType":{"type":"string","description":"The type of media property — website, mobile app, or social media account.","enum":["WEBSITE","MOBILE","SOCIAL"]},"MobilePlatform":{"type":"string","description":"The mobile operating system platform the app is published on.","enum":["IOS","ANDROID"]},"InstallsFollowers":{"type":"string","description":"Tiered count buckets for app installs (MOBILE) or social followers (SOCIAL).","enum":["HUNDRED_PLUS","THOUSAND_PLUS","TEN_THOUSAND_PLUS","HUNDRED_THOUSAND_PLUS","MILLION_PLUS","TEN_MILLION_PLUS","HUNDRED_MILLION_PLUS"]},"SocialPlatform":{"type":"string","description":"The social media platform the property is on.","enum":["FACEBOOK","X/TWITTER","INSTAGRAM","PINTEREST","YOUTUBE","TIKTOK","LINKEDIN","WECHAT","WEIBO","TWITCH"]}}},"paths":{"/Mediapartners/{AccountSID}/MediaProperties":{"get":{"operationId":"listMediaProperties","tags":["Media Properties"],"summary":"List all media properties","description":"Lists all media properties for your account.","parameters":[{"$ref":"#/components/parameters/AccountSID"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"MediaProperties":{"type":"array","items":{"$ref":"#/components/schemas/MediaProperty"}}}}}}}}}}}}
```
## Create a media property
> Creates a new media property object. New media properties need to be verified by impact.com before they are fully approved.
```json
{"openapi":"3.1.0","info":{"title":"Partner Media Properties API","version":"14"},"tags":[{"name":"Media Properties","description":"Endpoints for listing, creating, retrieving, updating, and deleting partner media properties."}],"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"parameters":{"AccountSID":{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."}},"schemas":{"PropertyType":{"type":"string","description":"The type of media property — website, mobile app, or social media account.","enum":["WEBSITE","MOBILE","SOCIAL"]},"MobilePlatform":{"type":"string","description":"The mobile operating system platform the app is published on.","enum":["IOS","ANDROID"]},"InstallsFollowers":{"type":"string","description":"Tiered count buckets for app installs (MOBILE) or social followers (SOCIAL).","enum":["HUNDRED_PLUS","THOUSAND_PLUS","TEN_THOUSAND_PLUS","HUNDRED_THOUSAND_PLUS","MILLION_PLUS","TEN_MILLION_PLUS","HUNDRED_MILLION_PLUS"]},"SocialPlatform":{"type":"string","description":"The social media platform the property is on.","enum":["FACEBOOK","X/TWITTER","INSTAGRAM","PINTEREST","YOUTUBE","TIKTOK","LINKEDIN","WECHAT","WEIBO","TWITCH"]},"RevenueModel":{"type":"string","description":"The monetization model used by a media property.","enum":["PAY_PER_LEAD","PAY_PER_INQUIRY","PAY_PER_SALE","PAY_PER_CLICK","PAY_PER_INSTALL"]}}},"paths":{"/Mediapartners/{AccountSID}/MediaProperties":{"post":{"operationId":"createMediaProperty","tags":["Media Properties"],"summary":"Create a media property","description":"Creates a new media property object. New media properties need to be verified by impact.com before they are fully approved.\n","parameters":[{"$ref":"#/components/parameters/AccountSID"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["Name","Type","Url"],"properties":{"Name":{"type":"string","description":"Display name of the media property."},"Type":{"$ref":"#/components/schemas/PropertyType"},"Url":{"type":"string","description":"The URL of the media property."},"MobilePlatform":{"$ref":"#/components/schemas/MobilePlatform"},"AppStoreRating":{"type":"integer","minimum":1,"maximum":5,"description":"App store rating out of 5. Applies to MOBILE type properties."},"Installs":{"$ref":"#/components/schemas/InstallsFollowers"},"SocialPlatform":{"$ref":"#/components/schemas/SocialPlatform"},"Followers":{"$ref":"#/components/schemas/InstallsFollowers"},"Thumbnail":{"type":"string","format":"binary","description":"Thumbnail image for the media property, as a binary upload."},"Description":{"type":"string","description":"A description of the media property and its audience."},"Tags":{"type":"string","description":"Comma-separated tags used to categorize this media property."},"RevenueModel":{"$ref":"#/components/schemas/RevenueModel","description":"The monetization model(s) used by this media property."},"MonthlyUniqueVisitors":{"type":"integer","description":"Estimated monthly unique visitors. Applies to WEBSITE type properties."},"AlexaRating":{"type":"integer","description":"Alexa global traffic rank for this media property. Applies to WEBSITE type properties."},"QuantcastRating":{"type":"integer","description":"Quantcast audience measurement rating. Applies to WEBSITE type properties."},"Price":{"type":"integer","description":"The price of the app in the app store. Applies to MOBILE type properties."},"Handle":{"type":"string","description":"The social media handle or username for this property. Applies to SOCIAL type properties."}}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string"},"Uri":{"type":"string"}}}}}}}}}}}
```
## Retrieve a media property
> Retrieves a media property for the specified Id value.
```json
{"openapi":"3.1.0","info":{"title":"Partner Media Properties API","version":"14"},"tags":[{"name":"Media Properties","description":"Endpoints for listing, creating, retrieving, updating, and deleting partner media properties."}],"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"parameters":{"AccountSID":{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."},"PropertyId":{"name":"Id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the media property."}},"schemas":{"MediaProperty":{"type":"object","properties":{"Id":{"type":"string","description":"Unique identifier for the media property."},"Name":{"type":"string","description":"Display name of the media property."},"Thumbnail":{"type":"string","description":"API resource path to the thumbnail image for this media property, if one has been uploaded."},"Description":{"type":"string","description":"A description of the media property and its audience."},"Tags":{"type":"string","description":"Comma-separated tags used to categorize this media property."},"RevenueModel":{"type":"array","description":"The monetization model(s) used by this media property.","items":{"$ref":"#/components/schemas/RevenueModel"}},"Url":{"type":"string","description":"The URL of the media property."},"Type":{"$ref":"#/components/schemas/PropertyType","description":"The type of media property."},"MonthlyUniqueVisitors":{"type":"string","description":"Estimated monthly unique visitors. Applies to WEBSITE type properties."},"AlexaRating":{"type":"string","description":"Alexa global traffic rank for this media property. Applies to WEBSITE type properties."},"QuantcastRating":{"type":"string","description":"Quantcast audience measurement rating. Applies to WEBSITE type properties."},"OwnershipVerified":{"type":"string","description":"Indicates whether ownership of this media property has been verified by impact.com."},"MobilePlatform":{"$ref":"#/components/schemas/MobilePlatform","description":"The mobile platform this app is published on. Applies to MOBILE type properties."},"AppStoreRating":{"type":"string","description":"App store rating out of 5. Applies to MOBILE type properties."},"Installs":{"$ref":"#/components/schemas/InstallsFollowers","description":"Estimated number of installs. Applies to MOBILE type properties."},"Price":{"type":"string","description":"The price of the app in the app store. Applies to MOBILE type properties."},"SocialPlatform":{"$ref":"#/components/schemas/SocialPlatform","description":"The social media platform this property is on. Applies to SOCIAL type properties."},"Followers":{"$ref":"#/components/schemas/InstallsFollowers","description":"Estimated number of followers or subscribers. Applies to SOCIAL type properties."},"Handle":{"type":"string","description":"The social media handle or username for this property. Applies to SOCIAL type properties."},"Uri":{"type":"string","description":"Unique reference to this media property in the impact.com API."}}},"RevenueModel":{"type":"string","description":"The monetization model used by a media property.","enum":["PAY_PER_LEAD","PAY_PER_INQUIRY","PAY_PER_SALE","PAY_PER_CLICK","PAY_PER_INSTALL"]},"PropertyType":{"type":"string","description":"The type of media property — website, mobile app, or social media account.","enum":["WEBSITE","MOBILE","SOCIAL"]},"MobilePlatform":{"type":"string","description":"The mobile operating system platform the app is published on.","enum":["IOS","ANDROID"]},"InstallsFollowers":{"type":"string","description":"Tiered count buckets for app installs (MOBILE) or social followers (SOCIAL).","enum":["HUNDRED_PLUS","THOUSAND_PLUS","TEN_THOUSAND_PLUS","HUNDRED_THOUSAND_PLUS","MILLION_PLUS","TEN_MILLION_PLUS","HUNDRED_MILLION_PLUS"]},"SocialPlatform":{"type":"string","description":"The social media platform the property is on.","enum":["FACEBOOK","X/TWITTER","INSTAGRAM","PINTEREST","YOUTUBE","TIKTOK","LINKEDIN","WECHAT","WEIBO","TWITCH"]}}},"paths":{"/Mediapartners/{AccountSID}/MediaProperties/{Id}":{"get":{"operationId":"retrieveMediaProperty","tags":["Media Properties"],"summary":"Retrieve a media property","description":"Retrieves a media property for the specified Id value.","parameters":[{"$ref":"#/components/parameters/AccountSID"},{"$ref":"#/components/parameters/PropertyId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaProperty"}}}}}}}}}
```
## Update a media property
> Updates the specified media property's attributes. Submitted parameter values will overwrite an attribute's existing value entirely.
```json
{"openapi":"3.1.0","info":{"title":"Partner Media Properties API","version":"14"},"tags":[{"name":"Media Properties","description":"Endpoints for listing, creating, retrieving, updating, and deleting partner media properties."}],"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"parameters":{"AccountSID":{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."},"PropertyId":{"name":"Id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the media property."}},"schemas":{"RevenueModel":{"type":"string","description":"The monetization model used by a media property.","enum":["PAY_PER_LEAD","PAY_PER_INQUIRY","PAY_PER_SALE","PAY_PER_CLICK","PAY_PER_INSTALL"]},"MobilePlatform":{"type":"string","description":"The mobile operating system platform the app is published on.","enum":["IOS","ANDROID"]},"InstallsFollowers":{"type":"string","description":"Tiered count buckets for app installs (MOBILE) or social followers (SOCIAL).","enum":["HUNDRED_PLUS","THOUSAND_PLUS","TEN_THOUSAND_PLUS","HUNDRED_THOUSAND_PLUS","MILLION_PLUS","TEN_MILLION_PLUS","HUNDRED_MILLION_PLUS"]},"SocialPlatform":{"type":"string","description":"The social media platform the property is on.","enum":["FACEBOOK","X/TWITTER","INSTAGRAM","PINTEREST","YOUTUBE","TIKTOK","LINKEDIN","WECHAT","WEIBO","TWITCH"]}}},"paths":{"/Mediapartners/{AccountSID}/MediaProperties/{Id}":{"put":{"operationId":"updateMediaProperty","tags":["Media Properties"],"summary":"Update a media property","description":"Updates the specified media property's attributes. Submitted parameter values will overwrite an attribute's existing value entirely.\n","parameters":[{"$ref":"#/components/parameters/AccountSID"},{"$ref":"#/components/parameters/PropertyId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"Name":{"type":"string","description":"Display name of the media property."},"Thumbnail":{"type":"string","format":"binary","description":"Thumbnail image for the media property, as a binary upload."},"Description":{"type":"string","description":"A description of the media property and its audience."},"Tags":{"type":"string","description":"Comma-separated tags used to categorize this media property."},"RevenueModel":{"$ref":"#/components/schemas/RevenueModel","description":"The monetization model(s) used by this media property."},"Url":{"type":"string","description":"The URL of the media property."},"MonthlyUniqueVisitors":{"type":"integer","description":"Estimated monthly unique visitors. Applies to WEBSITE type properties."},"AlexaRating":{"type":"integer","description":"Alexa global traffic rank for this media property. Applies to WEBSITE type properties."},"QuantcastRating":{"type":"integer","description":"Quantcast audience measurement rating. Applies to WEBSITE type properties."},"MobilePlatform":{"$ref":"#/components/schemas/MobilePlatform"},"AppStoreRating":{"type":"integer","description":"App store rating out of 5. Applies to MOBILE type properties."},"Price":{"type":"integer","description":"The price of the app in the app store. Applies to MOBILE type properties."},"Installs":{"$ref":"#/components/schemas/InstallsFollowers"},"SocialPlatform":{"$ref":"#/components/schemas/SocialPlatform"},"Followers":{"$ref":"#/components/schemas/InstallsFollowers"},"Handle":{"type":"string","description":"The social media handle or username for this property. Applies to SOCIAL type properties."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string"},"Uri":{"type":"string"}}}}}}}}}}}
```
## Delete a media property
> Permanently deletes the specified media property. This cannot be undone.
```json
{"openapi":"3.1.0","info":{"title":"Partner Media Properties API","version":"14"},"tags":[{"name":"Media Properties","description":"Endpoints for listing, creating, retrieving, updating, and deleting partner media properties."}],"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"parameters":{"AccountSID":{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."},"PropertyId":{"name":"Id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the media property."}}},"paths":{"/Mediapartners/{AccountSID}/MediaProperties/{Id}":{"delete":{"operationId":"deleteMediaProperty","tags":["Media Properties"],"summary":"Delete a media property","description":"Permanently deletes the specified media property. This cannot be undone.","parameters":[{"$ref":"#/components/parameters/AccountSID"},{"$ref":"#/components/parameters/PropertyId"}],"responses":{"200":{"description":"DELETED","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string"}}}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://integrations.impact.com/partner-api-reference/partner-v14/reference/media-properties/mediaproperties.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.