---
title: "Search"
method: POST
path: "/stac/search"
tags: ["SpatioTemporal Asset Catalog (STAC) API"]
---

# Search

`POST /stac/search`

STAC search operation.

## Query parameters

- `api-version` string, required
- `sign` 'true' | 'false'
- `duration` integer

## Request body

- StacSearchParameters — Search model. * Defines parameters for a STAC search POST request.
  - `collections` string[] — List of collection IDs to search within.
  - `ids` string[] — List of specific item IDs to return.
  - `bbox` number[] — Bounding box for spatial filtering in format [west, south, east, north].
  - `intersects` Geometry — Represents a GeoJSON geometry object as defined by RFC 7946. Supported geometry types include: - **Point**: A single geographic coordinate. - **LineString**: A sequence of geographic coordinates forming a line. - **Polygon**: A closed shape defined by linear rings. - **MultiPoint**: A collection of Points. - **MultiLineString**: A collection of LineStrings. - **MultiPolygon**: A collection of Polygons. Used for spatial filtering in STAC.
    - `type` string, required — Discriminator property for Geometry.
    - `bbox` number[] — Optional bounding box of the geometry.
  - `datetime` string — Temporal filter in RFC 3339 format, can be a single time or range.
  - `limit` integer — Maximum number of results to return.
  - `conf` object — Conf Overrides datetime validation from the base request model.
  - `query` object — STAC Query See the [STAC Query Extension](https://github.com/stac-api-extensions/query).
  - `sortby` StacSortExtension[] — Sort criteria for the search results. See the [STAC Sort Extension](https://github.com/stac-api-extensions/sort).
    - `field` string, required — The field name to sort by.
    - `direction` 'asc' | 'desc', required — Defines the sorting directions for query results in STAC API.
  - `fields` SearchOptionsFields[] — Specifies which fields to include or exclude in the STAC search results. See the [STAC Fields Extension](https://github.com/stac-api-extensions/fields).
    - `include` string[] — Array of field names to include in the response.
    - `exclude` string[] — Array of field names to exclude from the response.
  - `filter` object — CQL2 Filter See the [STAC Filter Extension](https://github.com/stac-api-extensions/filter).
  - `filter-crs` string — Coordinate reference system for the filter.
  - `filter-lang` 'cql-json' | 'cql2-json' | 'cql2-text' — Filter language to use for the filter expression.
  - `token` string — Pagination token for fetching the next set of results.

## Response `200`

The request has succeeded.

- StacItemCollection — Base type for STAC items and collections with discriminator.
  - `type` string, required — Discriminator property for StacItemOrStacItemCollection.
  - `stac_version` string — Stac Version
  - `links` StacLink[] — Links to related resources and endpoints.
    - `rel` string — The relationship type of the link.
    - `title` string — The title of the link.
    - `type` 'image/tiff; application=geotiff' | 'image/jp2' | 'image/png' | 'image/jpeg' | 'image/jpg' | 'image/webp' | 'application/x-binary' | 'application/xml' | 'application/json' | 'application/geo+json' | 'text/html' | 'text/plain' | 'application/x-protobuf' — The MIME type of the linked resource.
    - `href` string, required — The URL of the link.
    - `hreflang` string — The language of the linked resource.
    - `length` integer — The length of the linked resource.
    - `method` 'GET' | 'POST' — Specifies the HTTP method that the resource expects. Default: GET.
    - `headers` object — Object key-value pairs that map to headers. Example: { "Accept": "application/json" }.
    - `body` object — For POST requests, the resource can specify the HTTP body as a JSON object.
    - `merge` boolean — Indicates whether the client is expected to merge the body value into the current request body before following the link. This is only valid when the server is responding to a POST request. Default: false.
  - `msft:_created` string, date-time — MSFT Created
  - `msft:_updated` string, date-time — MSFT Updated
  - `msft:short_description` string — MSFT Short Description
  - `stac_extensions` string[] — URLs to STAC extensions implemented by this STAC resource.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/revisions/42447be18bc5/schema)