List Named Filters

Analyze Usage Data Coveo Relevance Cloud Business Analyst System Administrator Product Documentation

In this article

The Usage Analytics Read API filters/reporting endpoint allows you to retrieve the list of named filters in your Coveo™ organization (see /v15/filters/reporting). Ensure that you’re using an access token with Analytics - Named filters - View privilege in the target organization (see Add an API Key).

You will usually find it simpler to manage filters through the Administration Console (see Manage Named Filters). This article is only relevant if you have a legitimate reason for listing filters programmatically.

GET https://analytics.cloud.coveo.com/rest/ua/v15/filters/reporting?org=myOrg HTTP/1.1
 
Authorization: Bearer **********-****-****-****-************

200 OK response body (excerpt)

{
  "filters": [
    ...
    {
      "id": "EXCLUDE_PAGEVIEW_BOTS",
      "displayName": "Exclude pageView bots",
      "account": "myAccount",
      "type": "REPORTING",
      "value": "(custom_events.c_pageuseragent!@'aolbuild' AND custom_events.c_pageuseragent!@'baidu' AND custom_events.c_pageuseragent!@'bingbot' AND custom_events.c_pageuseragent!@'bingpreview' AND custom_events.c_pageuseragent!@'BaiduSpider' AND custom_events.c_pageuseragent!@'Coveobot' AND custom_events.c_pageuseragent!@'Duckduckgo' AND custom_events.c_pageuseragent!@'msnbot' AND custom_events.c_pageuseragent!@'adsbot-google' AND custom_events.c_pageuseragent!@'googlebot' AND custom_events.c_pageuseragent!@'mediapartners-google' AND custom_events.c_pageuseragent!@'teoma' AND custom_events.c_pageuseragent!@'slurp' AND custom_events.c_pageuseragent!@'yandex' AND custom_events.c_pageuseragent!@'WormlyBot' AND custom_events.c_pageuseragent!@'SMTBot' AND custom_events.c_pageuseragent!@'DuckDuckBot' AND custom_events.c_pageuseragent!@'JobboerseBot' AND custom_events.c_pageuseragent!@'mappydata.net/bot' AND custom_events.c_pageuseragent!@'Refindbot')"
    },
    ...
  ]
}

You can create named filters if desired.