Unified Search

GET {{baseUrl}}/api/v2/guide/search?query=<string>&filter[locales]=<string>&filter[category_ids]=<string>&filter[section_ids]=<string>&filter[topic_ids]=<string>&filter[external_source_ids]=<string>&filter[brand_ids]=<string>&filter[content_types]=<string>&page[after]=<string>&page[size]=<integer>

Request Params

KeyDatatypeRequiredDescription
querystringThe search text to be matched or a search string
filter[locales]string(Required) Limit the search to these locales. See Filtering by Locale
filter[category_ids]stringLimit the search to articles in these categories. See Filtering by Category
filter[section_ids]stringLimit the search to articles in these sections. See Filtering by Section
filter[topic_ids]stringLimit the search to posts in these topics. See Filtering by Topic
filter[external_source_ids]stringUse this parameter to scope the result of your search to a specific external source or external sources.
If no external source is given, results are returned across all sources
filter[brand_ids]stringLimit the search to articles or posts within these brands. If no brand is specified, results are returned across all brands.
If you want to scope the result of your search with multiple brands, separate each value with a comma
filter[content_types]stringLimit the search to one of these content types: ARTICLE, POST.
At present, it is not possible to specify EXTERNAL_RECORD.
Instead, use the filter[external_source_id] parameter above
page[after]stringA string representing the cursor to the next page.
page[size]stringA numeric value that indicates the maximum number of items that can
be included in a response. The value of this parameter has an upper
limit of 50. The default value is 10.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;meta&quot;:{&quot;after_cursor&quot;:&quot;\u003cstring\u003e&quot;,&quot;before_cursor&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_more&quot;:&quot;\u003cboolean\u003e&quot;},&quot;results&quot;:[{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;EXTERNAL_RECORD&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;},{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;EXTERNAL_RECORD&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;}]}