Querying API (v3.0)

Use the Querying API to fetch multiple pages of search results sequentially. This REST API lets you to retrieve entities that match specific criteria.

When using the Querying API, keep the following considerations in mind:

  • Due to deep paging considerations the querying endpoint is limited to retrieve up to 10,000 results.
  • When search results are sorted on a property and there are multiple results that have the same value for that property, then those results are displayed in random order. To address this limitation, use a secondary sort property as a tie-breaker.
  • With full-text search, do not use the following characters: «, », ÷,×, ¦, ¤, , or ؉. Do not combine special characters and wildcards within the same word. For example, use invoice reort instead of invoice-reort to ensure consistent results like invoice-report.
  • The FullText search property only supports the == operator, but can be negated.
  • When you run a query, make sure you include all the entity members that you want to retrieve. If you omit the members parameter, the response will return all the existing entity members (all properties, all relations, and so on). To ensure optimal performance, only request the members you actually need.
  • The API is configured to only load the related paths that are specified in a query. If you don't specify related path relations in your query, the response won't return any.

Authentication

To use the Querying API, you need:

  • The URL of your Content Hub server. You can get this from your Content Hub Administrator. Enter this URL in the {{server}} variable by hovering your mouse over the variable in the Try it pane and then clicking Edit.

  • An access token and the client ID. Both are sent with every request. You can create a token through the Content Hub interface or by requesting one using the API itself.

Download OpenAPI description
Overview
Languages
Servers

https://{server}/

Querying

The Querying API is responsible for fetching multiple pages of results sequentially.

The Querying API supports the following operators:

  • Equals
  • NotEquals
  • Gt
  • Lt
  • Gte
  • Lte
  • Contains
  • StartsWith
  • EndsWith
Operations