Query Feed Products - Markifact

Search the products inside an OpenAI Ads product feed with optional attribute filters (brand, price, availability, etc.). Read-only; returns matching product items plus matched/total counts.


App	OpenAI Ads
Operation ID	`openai_ads_query_feed_products`
Type	Action
Connection	`openai_ads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`feed_id`	string or SelectableOption	Yes	-	Product feed ID to query (from openai_ads_list_product_feeds).
`filters`	string or array of OpenAIAdsProductFilterItem	No	-	Optional filters on feed attributes, same shape as ad group product filters: a JSON list of {“field”, “operator”, “values”} objects, e.g. [{“field”: “brand”, “operator”: “in”, “values”: [“Acme”]}]. Fields: title, body, item_id, offer_id, price, target_url, image_url, product_category, brand, seller_name, external_seller_id, star_rating, condition, age_group. Operators: in, not_in, gt, gte, lt, lte, contains, not_contains, starts_with (numeric comparisons only on price and star_rating). Filters are ANDed.
`limit`	integer	No	`100`	Maximum number of products to return (1-10000).

OpenAIAdsProductFilterItem

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	Feed attribute to filter on.
`operator`	string or SelectableOption	Yes	-	‘in’/‘not_in’ match any of the values; ‘contains’/‘not_contains’/‘starts_with’ are text matches; ‘gt’/‘gte’/‘lt’/‘lte’ are numeric comparisons, allowed only on ‘price’ and ‘star_rating’.
`values`	string or array of string	No	-	Values to match — a list or a comma-separated string. Numbers are sent as strings (e.g. ‘25.00’).
`value`	string or array of string	No	-

SelectableOption

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

Output

Type: Dict Returns {products: […], matched_count, total_count} with product items exactly as returned by the OpenAI Ads API. Fields: dynamic (depend on the inputs) Example:

{
  "products": [
    {
      "item_id": "sku_1",
      "title": "Blue shoes"
    }
  ],
  "matched_count": 1,
  "total_count": 120
}