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

# Search

`GET /stac/search`

STAC search operation with query parameters.

## Query parameters

- `api-version` string, required
- `collections` string[]
- `ids` string[]
- `bbox` number[]
- `intersects` string
- `datetime` string
- `limit` integer
- `sign` 'true' | 'false'
- `duration` integer
- `query` string
- `sortby` string
- `fields` string
- `filter` string
- `filter-crs` string
- `filter-lang` 'cql-json' | 'cql2-json' | 'cql2-text'
- `token` string

## 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)