Skip to content

Content Search Page

The content search page query is intended to be used on a separate part of a site, such as an FAQ or a customer service section. A content search page query will return a search result content listing with applicable sort orders and total hits.


Request method


Request URL


Request parameters

Name Type Description Example
market string The visitor market identifier. Must match the corresponding market identifier in the data feed.
touchpoint string The visitor's touchpoint. Valid values are DESKTOP and MOBILE.
customerKey string A key that uniquely identifies the current visitor.
Using UUIDs as keys are recommended.
sessionKey string A unique key, identifying the session.
Using UUIDs as keys are recommended.
q string The executed search query.
origin string The Search origin of the search phrase. Defaults to ORGANIC. UNDO_AUTO_CORRECT
limit int The number of content items to list. Defaults to 60 if omitted in the query. 60
skip int The number of content items to skip. Used for pagination, defaults to 0 if omitted in the query. 48
sort string The applied Sort order in the search result. Strongly recommended to omit for initial searches. Only recommended for explicit visitor interaction after initial searches. NEWEST_FIRST
notify boolean A boolean that can be used to disable notifications and behavioural registration for the query. false
viewId string A parameter that is used to show the page in either production or preview mode. Can be production or preview. Defaults to production if omitted in the query. For more information, see App Integration. production

Search origin

To correctly track and analyse search behaviour, searches that originate from autocomplete suggestions, triggered through did-you-mean, or are actual organic searches are differentiated.

Name Description
ORGANIC The search was organic, e.g. the phrase was typed and executed by a visitor without any assistance or suggestion interaction.
DID_YOU_MEAN The search phrase originated from a did-you-mean suggestion in the search.
UNDO_AUTO_CORRECT A search phrase which forcibly omits autocorrect. Used when visitors have phrases autocorrected, and are presented with the option to redo the search using the original phrase.

Request headers

All request headers are optional, but recommended when eligible.

  • Content-Type - application/json. To prevent automatic browser preflight requests, text/plain is also supported.
  • Accept-Encoding - gzip. Allows responses to be compressed using Gzip.
  • User-Agent - User agent. Enables internal tracking.

Request body

Request method usage

The POST request method should be used when supplying a request body.

The search result of the content search page can be configured to be restricted through a content filter.

Name Type Description
primaryList PrimaryList A configuration object allowing filter restrictions of the primary listing, i.e. the search results.

Primary list

Request example
    "primaryList": {
        "contentFilter": {
            "type": "faq"
Name Type Description
contentFilter ContentFilter A content filter restricting which content that the listing may contain.

Request example

A content search page query example is demonstrated using cURL below.

curl -i \
-H "Accept-Encoding: gzip" \
-H "User-Agent: {client user agent}" \

Request example 2

A content search page query example using POST is demonstrated below.

curl -i \
-T request-body.json \
-H "Content-Type: text/plain" \
-H "Accept-Encoding: gzip" \
-H "User-Agent: {client user agent}" \


  "primaryList": {
    "contentFilter": {
      "type": "article"


Response headers


Response content-type


Response codes

Response Description
200 Query accepted, content flattened and serialised to JSON, see Response objects.
400 Invalid or missing arguments for this query.
404 End point is not valid.
503 Service unavailable, no products found in the cluster.
5xx Server error such as cluster unavailable or busy. The response body may contain more information about the error.

Response objects

    "q" : "shiping",
    "autoCorrect": {
        "q": "shipping",
        "originalTotalHits": 0
    "didYouMean": [],
    "primaryList" : {
        "totalHits": 3,
        "items": [
                "key": "S1",
                "type": "article",
                "title": "Shipping",
                "link": "/shipping",
                "ticket": "Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7",
                "releaseDate": "2019-12-01T00:00:00Z",
                "description": "We ship to all of the EU.",
                "image": {
                    "sources": [{"url": "img-w500.jpg", "width": 500}, {"url": "img-w1000.jpg", "width": 1000}]
                "custom": {
                    "modifiedTime": [{"id": "2021-02-04", "label": "2021-02-04"}],
                    "author": [{"id": "John Doe", "label": "John Doe"}]
            // Potentially more content items
        "sort": {
            "selected": "RELEVANCE",
            "options": [ 
                {"id" : "RELEVANCE", "label": "Most popular"},
                {"id" : "NEWEST_FIRST", "label": "Newest first"}
Name Type Description
primaryList PrimaryList A content list with the search result.
q string The search query used for the current result. May be corrected and differ from the requested query.
didYouMean DidYouMean[ ] A list of did-you-mean suggestions.
autoCorrect? AutoCorrect Information about applied auto corrections to the search phrase.
Omitted if no correction was made.


Name Type Description
sort Sort How the content is sorted and the available sort options.
items ContentItem[ ] A list of the result of the search.
totalHits number The total number of content item hits.
Name Type Description
selected SortType Which sort type is currently selected.
options SortOptions[ ] Which sort types to choose from.
Name Type Description
id SortType Identifier for the SortOption.
label string The presentation text for the SortOption.
Name Description
RELEVANCE The most relevant content first, based on the match with the query and clicks on content.
NEWEST_FIRST The newest content first, determined by release date provided in the product feed.

Last update: October 8, 2021
Back to top

This online publication is intellectual property of Apptus Technologies. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Apptus Technologies nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Apptus Technologies essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.