Stores

Endpoints for browsing partner storefronts, their groups, and the catalog items inside them.

List all stores

get

Returns a list of all stores available to your partner account.

Authorizations

basicAuth

AuthorizationstringRequired

Use your AccountSID as the username and AuthToken as the password.

Path parameters

AccountSIDstringRequired

Unique identifier for the partner account.

Responses

200

An array of stores.

application/json

get/Mediapartners/{AccountSID}/Stores

curl

curl -L \
  --url 'https://api.impact.com/Mediapartners/{AccountSID}/Stores' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: application/json'

200

An array of stores.

{
  "Stores": [
    {
      "Id": "10306",
      "Name": "Hazel's Wellness Picks",
      "NumberOfGroups": "1",
      "DateLastUpdated": "2025-06-20T08:03:12-07:00",
      "StoreUri": "https://member.impactradius.com/secure/mediapartner/ads/view-partner-storefront-flow.ihtml?storefrontId=10306",
      "StoreAvatar": "https://cdn2.impact.com/display-logo-via-campaign/10306.png",
      "StoreBanner": "https://product.impact.com/productservices/apps/assets/banner/MTAzMDZfRnJpIEp1biAyMCAxNTowMzoxMSBVVEMgMjAyNQ==.JPG",
      "Uri": "/Mediapartners/<AccountSID>/Stores/10306",
      "Groups": [
        {
          "Id": "817",
          "Name": "Professional Equipment",
          "NumberOfProducts": "17",
          "DateLastUpdated": "2025-06-20T08:01:43-07:00",
          "StartDate": "",
          "EndDate": "",
          "Status": "ACTIVE",
          "CatalogId": "24836",
          "Uri": "https://member.impactradius.com/secure/mediapartner/ads/view-products-flow.ihtml#/partnerproducts/campaignId=10306&ProductGroups=817",
          "ItemsUri": "/Mediapartners/<AccountSID>/Stores/10306/Group/817/Items",
          "GroupProductPreview": ""
        }
      ]
    }
  ]
}

Retrieve a store

get

Retrieves a store's details, including its curated groups.

Authorizations

basicAuth

AuthorizationstringRequired

Use your AccountSID as the username and AuthToken as the password.

Path parameters

AccountSIDstringRequired

Unique identifier for the partner account.

IdstringRequired

Unique identifier for the store.

Query parameters

ShowAutoCreatedGroupsstring · enumOptional

When TRUE (the default), the response includes groups that impact.com auto-generated for the storefront. Set to FALSE to return only brand-curated groups.

Default: TRUEPossible values:

Responses

200

A store object.

application/json

IdstringOptional

Unique identifier for the store (also the brand's Campaign ID).

Example: 10306

NamestringOptional

Display name of the store as shown on the brand's storefront.

Example: Hazel's Wellness Picks

NumberOfGroupsstringOptional

Number of curated groups in this store.

Example: 1

DateLastUpdatedstring · date-timeOptional

Date and time the store was last updated (ISO 8601).

Example: 2025-06-20T08:03:12-07:00

StoreUristringOptional

Web URL to view this store in the impact.com interface.

Example: https://member.impactradius.com/secure/mediapartner/ads/view-partner-storefront-flow.ihtml?storefrontId=10306

StoreAvatarstringOptional

Public CDN URL of the brand's logo for this store. May be empty.

Example: https://cdn2.impact.com/display-logo-via-campaign/10306.png

StoreBannerstringOptional

Public CDN URL of the storefront banner image. May be empty.

Example: https://product.impact.com/productservices/apps/assets/banner/MTAzMDZfRnJpIEp1biAyMCAxNTowMzoxMSBVVEMgMjAyNQ==.JPG

UristringOptional

API resource path for this store.

Example: /Mediapartners/<AccountSID>/Stores/10306

404

No store exists with the supplied Id.

get/Mediapartners/{AccountSID}/Stores/{Id}

curl

curl -L \
  --url 'https://api.impact.com/Mediapartners/{AccountSID}/Stores/{Id}' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: application/json'

{
  "Id": "10306",
  "Name": "Hazel's Wellness Picks",
  "NumberOfGroups": "1",
  "DateLastUpdated": "2025-06-20T08:03:12-07:00",
  "StoreUri": "https://member.impactradius.com/secure/mediapartner/ads/view-partner-storefront-flow.ihtml?storefrontId=10306",
  "StoreAvatar": "https://cdn2.impact.com/display-logo-via-campaign/10306.png",
  "StoreBanner": "https://product.impact.com/productservices/apps/assets/banner/MTAzMDZfRnJpIEp1biAyMCAxNTowMzoxMSBVVEMgMjAyNQ==.JPG",
  "Uri": "/Mediapartners/<AccountSID>/Stores/10306",
  "Groups": [
    {
      "Id": "817",
      "Name": "Professional Equipment",
      "NumberOfProducts": "17",
      "DateLastUpdated": "2025-06-20T08:01:43-07:00",
      "StartDate": "",
      "EndDate": "",
      "Status": "ACTIVE",
      "CatalogId": "24836",
      "Uri": "https://member.impactradius.com/secure/mediapartner/ads/view-products-flow.ihtml#/partnerproducts/campaignId=10306&ProductGroups=817",
      "ItemsUri": "/Mediapartners/<AccountSID>/Stores/10306/Group/817/Items",
      "GroupProductPreview": ""
    }
  ]
}

List items in a store group

get

Returns the catalog items belonging to the given store and group, sorted by most recently created.

Authorizations

basicAuth

AuthorizationstringRequired

Use your AccountSID as the username and AuthToken as the password.

Path parameters

AccountSIDstringRequired

Unique identifier for the partner account.

IdstringRequired

Unique identifier for the store containing the group.

GroupIdstringRequired

Unique identifier for the group whose items you want to list.

Query parameters

QuerystringOptional

Narrows the list by attribute (e.g., CurrentPrice > 10.00).

Responses

200

An array of catalog item objects.

application/json

404

No store or group exists with the supplied Ids.

get/Mediapartners/{AccountSID}/Stores/{Id}/Group/{GroupId}/Items

curl

curl -L \
  --url 'https://api.impact.com/Mediapartners/{AccountSID}/Stores/{Id}/Group/{GroupId}/Items' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: application/json'

{
  "Items": [
    {
      "Id": "product_24836_APP-0016",
      "CatalogId": "24836",
      "CampaignId": "10306",
      "CampaignName": "Wayne Enterprises",
      "CatalogItemId": "APP-0016",
      "Name": "Wayne Reactive Armor Vest",
      "Description": "Wayne Reactive Armor Vest by Wayne Enterprises.",
      "MultiPack": "",
      "Bullets": [
        "text"
      ],
      "Labels": [
        "text"
      ],
      "Manufacturer": "Wayne Enterprises",
      "Url": "https://example.sjv.io/c/1924609/3061936/10306?prodsku=APP-0016",
      "MobileUrl": "",
      "ImageUrl": "https://wayne.limited/images/armorvest.jpg",
      "ProductBid": "",
      "AdditionalImageUrls": [
        "text"
      ],
      "Promotions": [
        "text"
      ],
      "CurrentPrice": "719.10",
      "OriginalPrice": "799.00",
      "DiscountPercentage": "10",
      "Currency": "USD",
      "StockAvailability": "InStock",
      "EstimatedShipDate": "",
      "LaunchDate": "",
      "ExpirationDate": "",
      "Gtin": "7774561230001",
      "GtinType": "EAN",
      "Asin": "",
      "Mpn": "ARM-VST-01",
      "ShippingRate": "",
      "ShippingWeight": "",
      "ShippingWeightUnit": "",
      "ShippingLength": "",
      "ShippingWidth": "",
      "ShippingHeight": "",
      "ShippingLengthUnit": "",
      "ShippingLabel": "",
      "Category": "Apparel & Accessories > Clothing > Outerwear",
      "SubCategory": "",
      "AdvertiserFormatCategories": [
        "text"
      ],
      "OriginalFormatCategory": "Apparel & Accessories > Clothing > Outerwear",
      "OriginalFormatCategoryId": "",
      "ParentName": "",
      "ParentSku": "",
      "IsParent": false,
      "ItemGroupId": "",
      "Colors": [
        "text"
      ],
      "Material": "",
      "Pattern": "",
      "Size": "",
      "SizeUnit": "",
      "Weight": "",
      "WeightUnit": "",
      "Condition": "New",
      "AgeGroup": "",
      "AgeRangeMin": "0",
      "AgeRangeMax": "0",
      "AgeRangeUnit": "",
      "Gender": "",
      "Adult": "",
      "Text1": "",
      "Text2": "",
      "Text3": "",
      "Numeric1": "",
      "Numeric2": "",
      "Numeric3": "",
      "Money1": "",
      "Money2": "",
      "Money3": "",
      "Uri": "/Mediapartners/<AccountSID>/Catalogs/24836/Items/product_24836_APP-0016"
    }
  ]
}