---
title: Perform a query
slug: '1445'
canonical_url: https://docs.coveo.com/en/1445/
collection: build-a-search-ui
source_format: adoc
---
# Perform a query
You can perform a [query](https://docs.coveo.com/en/231/) by sending a GET or POST HTTP request to:

* `+https://<ORG_ID>.org.coveo.com/rest/search/v2+` for a [Coveo organization](https://docs.coveo.com/en/185/), where `<ORG_ID>` is the unique identifier of your [organization](https://docs.coveo.com/en/185/).

Under the hood, the [Coveo Platform](https://docs.coveo.com/en/186/) will redirect you based on your [primary deployment region](https://docs.coveo.com/en/2976/):

** USA: [platform.cloud.coveo.com/rest/search/v2](https://platform.cloud.coveo.com/rest/search/v2)

** Canada: [platform-ca.cloud.coveo.com/rest/search/v2](https://platform-ca.cloud.coveo.com/rest/search/v2)

** Australia: [platform-au.cloud.coveo.com/rest/search/v2](https://platform-au.cloud.coveo.com/rest/search/v2)

** Europe: [platform-eu.cloud.coveo.com/rest/search/v2](https://platform-eu.cloud.coveo.com/rest/search/v2)

* `+https://<ORG_ID>.orghipaa.coveo.com/rest/search/v2+` for a [HIPAA organization](https://docs.coveo.com/en/1853/).

Under the hood, the [Coveo Platform](https://docs.coveo.com/en/186/) will redirect you to: [https://platformhipaa.cloud.coveo.com/rest/search/v2](https://platformhipaa.cloud.coveo.com/rest/search/v2).

The Search API [query](https://docs.coveo.com/en/231/) route supports several [parameters](https://docs.coveo.com/en/13#tag/Search-V2/operation/searchUsingPost) which you can specify either in the [query](https://docs.coveo.com/en/231/) string, or in the JSON body of a POST request.

## Query examples

. Performing a [query](https://docs.coveo.com/en/231/) using the GET method:

```http
GET https://myorganizationid9sd8df7s.org.coveo.com/rest/search/v2?q=test HTTP/1.1
​
Accept: application/json
Authorization: Bearer **********-****-****-****-************
```

. Performing a [query](https://docs.coveo.com/en/231/) using the POST method:

```http
POST https://myorganizationid9sd8df7s.org.coveo.com/rest/search/v2 HTTP/1.1
​
Content-Type: application/json
Accept: application/json
Authorization: Bearer **********-****-****-****-************
```

**Payload**

```json
{
  "q": "test"
}
```

## `GET` vs. `POST`

Semantically, using the GET method to perform a [query](https://docs.coveo.com/en/231/) makes sense.
However, using the POST method is also legitimate, as a request body typically lends itself better to specifying complex parameters involving sub-objects (for example, [`groupBy`](https://docs.coveo.com/en/13#operation/searchUsingPost-groupBy)) than a [query](https://docs.coveo.com/en/231/) string does.
For the sake of readability, this documentation uses the POST method in most examples and code samples.

### Detailed query example using POST

In a graphical [search interface](https://docs.coveo.com/en/2741/) for an American bookstore, the user has selected the **Books** [tab](https://docs.coveo.com/en/1406/) and checked the **Arthur Conan Doyle** value in the **Authors** [facet](https://docs.coveo.com/en/198/).
The user then types `adventure` in the search box and submits the [query](https://docs.coveo.com/en/231/).
The resulting search request to the Search API looks like the following:

```http
POST https://myorganizationid9sd8df7s.org.coveo.com/rest/search/v2 HTTP/1.1
​
Content-Type: application/json
Accept: application/json
Authorization: Bearer **********-****-****-****-************
```

**Payload**

```json
{
  "locale": "en-US",
  "searchHub": "BookstoreSearch",
  "tab": "Books",
  "cq": "@source==Books",
  "aq": "@author==\"Arthur Conan Doyle\"",
  "q": "adventure",
  "groupBy": [
    {
      "field": "@author",
      "sortCriteria": "AlphaAscending"
    },
    {
      "field": "@genre",
      "sortCriteria": "occurrences"
    }
  ]
}
```

**200 OK response body (excerpt)**

```json
{
  ...
  "duration": 35,
  "groupByResults": [
    ...
  ],
  "indexDuration": 11,
  "requestDuration": 33,
  "results": [
    {
      "clickUri": "https://example.com/bookstore/books/authors/arthur-conan-doyle/adventures-of-sherlock-holmes",
      "excerpt": "The Adventures of Sherlock Holmes, a collection of 12 Sherlock Holmes tales ... written by Sir Arthur Conan Doyle and published in 1892 ...",
      "excerptHighlights": [
        {
          "length": 10,
          "offset": 4
        }
      ],
      "percentScore": 75.0698,
      "printableUri": "https://example.com/bookstore/books/authors/arthur-conan-doyle/adventures-of-sherlock-holmes",
      "printableUriHighlights": [
        {
          "length": 10,
          "offset": 63
        }
      ],
      "raw": {
        "date": 1532631456000,
        "author": "Arthur Conan Doyle",
        "documenttype": "Book",
        "filename": "adventures-of-sherlock-holmes.html",
        "filetype": "html",
        "indexeddate": 1532631456000,
        "language": [
          "English"
        ],
        "permantentid": "ecc3fac22085f2712c8cd2144f9d195593710963dc2202b5256f8a4f5f6",
        "size": 50683,
        "source": "Books",
        "sourcetype": "Push",
        "title": "The Adventures of Sherlock Holmes",
        ...
      },
      "score": 4904,
      "title": "The Adventures of Sherlock Holmes",
      "titleHighlights": [
        {
          "length": 10,
          "offset": 4
        }
      ],
      "uniqueId": "42.19751$https://example.com/bookstore/books/authors/arthur-conan-doyle/adventures-of-sherlock-holmes",
      "uri": "https://example.com/bookstore/books/authors/arthur-conan-doyle/adventures-of-sherlock-holmes"
    },
    ...
  ],
  "searchUid": "7beff9c1-98f3-401c-ac16-10b90a8b810f",
  "totalCount": 60,
  "totalCountFiltered": 60,
  ...
}
```