List Shared List Items - Markifact

Read the contents of a Microsoft Ads shared list: the keywords in a negative keyword list, the websites in a placement list, or the brand IDs in a brand list. This is the only way to obtain brand IDs, because Microsoft has no operation that looks a brand up by name.


App	Microsoft Ads
Operation ID	`microsoft_ads_list_shared_list_items`
Type	Action
Connection	`microsoft_ads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`account`	object or array of object or MicrosoftAdsAccountItem or string or integer	Yes	-	Select the Microsoft Ads account that owns the shared list.
`list_id`	string or integer	Yes	-	ID of the shared list to read. microsoft_ads_list_shared_lists returns these.
`list_type`	string or SelectableOption	Yes	-	The list’s type, which Microsoft requires in order to read its contents. NegativeKeywordList returns keywords, the placement lists return website URLs, and BrandList returns brand IDs. Read it from microsoft_ads_list_shared_lists rather than guessing.
`limit`	integer	No	`1000`	Maximum number of items to return. Defaults to 1000.

MicrosoftAdsAccountItem

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-
`customerId`	string	No	-	The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns the list’s items. Which value field is populated depends on the list type: text for keywords, url for websites, brand_id for brands. Fields: list_id, item_id, type, text, match_type, url, brand_id