Search user content

1 min

POST

https://{hostname}/1.0/users/{id}/content/_filter

Paginated list of content matching a Lucene query ordered by relevance to the user.

Query Parameters

pageinteger
Example
2
Description
Page number for pagination (1-based index).
rppinteger
Description
Results per page for pagination.
include_topicsboolean
Description
Whether to include topic information in the response.

Body Parameters

bodyContentQueryrequired
Description
Lucene query
- querystringrequired
  Example
  title:AI AND language:en
  Description
  Lucene query string. Use the platform's Lucene dialect for advanced filtering.

Responses

200A list of content accompanied by metadata for navigation and recommendation tracking.

UserContentList
Example
```
{
  "total_hits": 42,
  "next_page": "https://api.usea01.idio.episerver.net/1.0/users/1234/content?page=2&rpp=10",
  "previous_page": null,
  "recommendation_id": "8f14e45f-ceea-467a-9575-6c1e3d2a7b9c",
  "model": true,
  "group": "test",
  "content": [
    {
      "id": 987654,
      "title": "The Future of Enterprise Personalisation",
      "abstract": "How content recommendations drive engagement across digital channels.",
      "featured": true,
      "approved": "approved",
      "read": false,
      "published": "2026-05-14T09:30:00Z",
      "original_url": "https://www.example.com/blog/future-of-personalisation",
      "link_url": "https://www.example.com/blog/future-of-personalisation",
      "full_details_url": "https://api.usea01.idio.episerver.net/1.0/content/987654",
      "main_image_url": "https://images.example.com/987654/main.jpg",
      "main_image": {
        "width": 1200,
        "height": 630
      },
      "metadata": {
        "language": "en"
      },
      "source": {
        "id": 55,
        "title": "Company Blog",
        "full_details_url": "https://api.usea01.idio.episerver.net/1.0/sources/55",
        "display": "full"
      },
      "author": {
        "id": 21,
        "title": "Jordan Lee",
        "full_details_url": "https://api.usea01.idio.episerver.net/1.0/authors/21"
      },
      "topics": [
        {
          "id": 301,
          "title": "Personalisation",
          "full_details_url": "https://api.usea01.idio.episerver.net/1.0/topics/301"
        }
      ]
    }
  ]
}
```
- objectContentList
  - total_hitsintegerrequired
    Description
    Total number of items matching the query.
  - next_pagestring<url>
    Description
    Link to the next page of results, if available.
    Format
    url
  - previous_pagestring<url>
    Description
    Link to the previous page of results, if available.
    Format
    url
  - contentContentItem[]required
    Description
    The list of content items for the current page.
    - ContentItemMinimal
      - titlestring
        Description
        Title of the content item.
      - abstractstring
        Description
        Short summary or abstract of the content.
      - featuredboolean
        Description
        Indicates whether the content is featured.
      - approvedstring<approved | unapproved | binned>
        Description
        Approval status of the content.
        Allowed
        approvedunapprovedbinned
      - readboolean
        Description
        Whether the content is marked as read.
      - publishedstring<date-time>
        Description
        Date and time when the content was published.
        Format
        date-time
      - original_urlstring<url>
        Description
        Original source URL of the content.
        Format
        url
    - object
      - idintegerrequired
        Description
        Unique identifier of the content item.
      - metadataContentMetadatarequired
        Description
        Metadata for a content item, such as language and tags.
        languagestring<de | en | es | fr | it>
        Description
        Language of the content.
        Allowed
        deenesfrit
        tagsmap<string, string>
        Description
        Arbitrary namespaced tags associated with the content. Values may be strings or arrays of strings (for example, multiple authors).
      - topicsContentTopic[]
        Description
        Topic information associated with the content.
        idintegerrequired
        Description
        Unique identifier of the topic.
        titlestringrequired
        Description
        Topic title.
        full_details_urlstring<url>required
        Description
        API link to full topic details.
        Format
        url
      - link_urlstring<url>required
        Description
        URL to the live content link.
        Format
        url
      - full_details_urlstring<url>required
        Description
        API URL for full details of the content.
        Format
        url
      - main_image_urlstring<url>required
        Description
        URL to the main image of the content.
        Format
        url
      - main_imageContentMainImagerequired
        widthintegerrequired
        Description
        Image width in pixels.
        heightintegerrequired
        Description
        Image height in pixels.
      - sourceContentSourcerequired
        Description
        The source (origin) of the content.
        idintegerrequired
        Description
        Unique identifier of the source.
        titlestringrequired
        Description
        Display name of the source.
        full_details_urlstring<url>required
        Description
        API URL for full source details.
        Format
        url
        displaystring<full | abstract | link>required
        Description
        How the source should be displayed.
        Allowed
        fullabstractlink
      - authorContentAuthorrequired
        idintegerrequired
        Description
        Unique identifier of the author.
        titlestringrequired
        Description
        Name of the author.
        full_details_urlstring<url>required
        Description
        API URL for full author details.
        Format
        url
- object
  - recommendation_idstring<uuid>
    Description
    Unique identifier for the recommendation set.
    Format
    uuid
  - modelbooleanrequired
    Description
    Indicates whether a recommendation model was applied.
  - groupstring<control | test>required
    Description
    A/B test group identifier.
    Allowed
    controltest

204No content matching query

404User does not exist

curl

curl --request POST \
     --url https://api.usea01.idio.episerver.net/1.0/users/{id}/content/_filter \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "query": "title:AI AND language:en"
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "query": "title:AI AND language:en"
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.usea01.idio.episerver.net/1.0/users/{id}/content/_filter", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://api.usea01.idio.episerver.net/1.0/users/{id}/content/_filter")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "query": "title:AI AND language:en"
})

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://api.usea01.idio.episerver.net/1.0/users/{id}/content/_filter"

payload = json.dumps({
   "query": "title:AI AND language:en"
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

// A list of content accompanied by metadata for navigation and recommendation tracking.
{
  "total_hits": 0,
  "next_page": "",
  "previous_page": "",
  "content": {},
  "recommendation_id": "",
  "model": false,
  "group": ""
}

204

// No content matching query

404

// User does not exist