---
title: "POST /search/query"
method: POST
path: "/search/query"
tags: ["Discovery"]
---

# POST /search/query

`POST /search/query`

Gets data using search.

## Query parameters

- `api-version` string, required

## Request body

- SearchRequest — The search query of advanced search request.
  - `keywords` string — The keywords applied to all searchable fields.
  - `offset` integer — The offset. The default value is 0. The maximum value is 100000.
  - `limit` integer — The limit of the number of the search result. default value is 50; maximum value is 1000.
  - `orderby` SearchOrderItem[] — The sort order of search results, can specify multiple fields.
  - `filter` object — The filter for the search. See examples for the usage of supported filters.
  - `facets` SearchFacetItem[]
    - `count` integer — The count of the facet item.
    - `facet` string — The name of the facet item.
    - `sort` object
  - `taxonomySetting` object
    - `assetTypes` string[]
    - `facet` SearchFacetItem — The content of a search facet result item.
      - `count` integer — The count of the facet item.
      - `facet` string — The name of the facet item.
      - `sort` object

## Response `200`

OK. On successful lookup of the advanced search.

- SearchResult — The result of the search result.
  - `@search.count` integer — The total number of search results (not the number of documents in a single page).
  - `@search.facets` SearchFacetResultValue — A facet list that consists of index fields assetType ,classification, contactId, and label. When the facet is specified in the request, the value of the facet is returned as an element of @search.facets.
    - `entityType` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `assetType` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `classification` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `term` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `contactId` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `contactType` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `label` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `glossaryType` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `termStatus` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
    - `termTemplate` SearchFacetItemValue[]
      - `count` integer — The count of the facet item.
      - `value` string — The name of the facet item.
  - `value` SearchResultValue[]
    - `@search.score` number, float — The search score calculated by the search engine. The results are ordered by search score by default.
    - `@search.highlights` SearchHighlights — A highlight list that consists of index fields id ,qualifiedName, name, description, entityType. When the keyword appears in those fields, the value of the field, attached with emphasis mark, is returned as an element of @search.highlights.
      - `id` string[]
      - `qualifiedName` string[]
      - `name` string[]
      - `description` string[]
      - `entityType` string[]
    - `objectType` string — The object type of the record. Object type is the top-level property to distinguish whether a record is an asset or a term.
    - `createTime` integer — The create time of the record. The Unix epoch format.
    - `updateTime` integer — The last update time of the record. The Unix epoch format.
    - `id` string — The GUID of the record.
    - `name` string — The name of the record.
    - `qualifiedName` string — The qualified name of the record.
    - `entityType` string — The type name of the asset.
    - `description` string — The description of the asset.
    - `endorsement` string[] — The endorsement of the asset.
    - `owner` string — The owner of the record. This is an Atlas native attribute.
    - `classification` string[] — The classifications of the record.
    - `label` string[] — The labels of the asset.
    - `term` TermSearchResultValue[] — The terms assigned to the asset.
      - `name` string — The name of the term.
      - `glossaryName` string — The name of the glossary which contains the term.
      - `guid` string — The GUID of the term.
    - `contact` ContactSearchResultValue[] — The contacts of the asset.
      - `id` string — The GUID of the contact.
      - `info` string — The description of the contact.
      - `contactType` string — The type of the contact. It can be Expert or Owner for an entity. It can be Expert or Steward for a glossary term.
    - `assetType` string[] — The asset types of the asset.
    - `glossaryType` string — The type name of the term. Could be AtlasGlossary, AtlasGlossaryTerm or AtlasGlossaryCategory.
    - `glossary` string — The glossary name of the term.
    - `termStatus` string — The status of the term.
    - `termTemplate` string[] — The term template names used by the term.
    - `longDescription` string — The definition of the term.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/purview-catalog.md) · [All operations](https://skmtc.net/azure/apis/purview-catalog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/purview-catalog/revisions/63dd676f9a6b/schema)