Sitecore API catalog
/
Querying API
/
Querying

Querying API (v1.0)

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

The Try it functionality available from the API documentation lets you explore API endpoints and make calls directly from the documentation.

Authentication

To use the Try it feature of the Querying API, you need:

Download OpenAPI description
index.json
index.yaml
Overview
License closed source
Languages
Servers
https://{server}/

Querying

Use the Querying API to fetch multiple pages of search results sequentially.

Operations

Retrieve a list of entities based on a search query

Request

Lists all entities that match the criteria. This endpoint supports sorted pagination using the search_after parameter.

Query
querystringrequired

The search query.

Example: query=Definition.Name == 'M.Asset'
takeinteger(int32)

The number of items to take. If not specified, a default value is used.

Example: take=25
membersstring

Indicates how resulting entities should be loaded.

Example: members=Title,Filename
renditionsstring

The renditions that will be loaded with the resulted entities.

culturestring

The user's culture.

Example: culture=en-us
sortstring

Defines how the results should be sorted.

Example: sort=created_on
orderstring

Defines the results sort order.

Example: order=desc
sortCulturestring

The sort's culture.

Example: sortCulture=en-us
searchAfterArray of strings

To retrieve the next page of results using a set of sort values from the previous results. For example, if you make a request and receive 100 results, ending with entity_id_1, your subsequent query can include search_after=entity_id_1 to fetch the next page.

nestedRelationsArray of strings

The nested relations that are loaded with the resulting entities.

curl -i -X GET \
  'https://your-server/api/entities/searchAfter?culture=en-us&members=Title%2CFilename&nestedRelations=string&order=desc&query=Definition.Name%20%3D%3D%20'\''M.Asset'\''&renditions=string&searchAfter=string&sort=created_on&sortCulture=en-us&take=25' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful operation

Bodyapplication/json
last_hit_dataArray of strings or null

The last returned results, which are used to fetch the next page of results.

itemsArray of objects or null(EntityResource)

Gets or sets the list of items.

total_itemsinteger or null(int64)

Gets or sets the total number of items.

returned_itemsinteger or null(int64)

Gets or sets the number of returned items.

offsetinteger or null(int32)

Gets or sets the offset of the items.

nextobject(Link)

Represents a link to a resource.

previousobject(Link)

Represents a link to a resource.

identifierstring or null

Gets or sets the identifier of the resource.

selfobject(Link)

Represents a link to a resource.

property name*anyadditional property
Response
application/json
{
  "last_hit_data": [
    "string"
  ],
  "items": [
    { … }
  ],
  "total_items": 0,
  "returned_items": 0,
  "offset": 0,
  "next": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "previous": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "identifier": "string",
  "self": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "property1": null,
  "property2": null
}