---
title: "Search STAC items with full-featured filtering."
method: POST
path: "/search"
tags: ["Item Search"]
---

# Search STAC items with full-featured filtering.

`POST /search`

Retrieve items matching filters. Intended as the standard, full-featured
query API.

This method is optional to implement, but recommended.

If this endpoint is implemented on a server, it is required to add a
link referring to this endpoint with `rel` set to `search` and `method`
set to `POST` to the `links` array in `GET /`.

## Request body

- SearchBody — Only returns maximum number of results (page size)
  - `bbox` Bbox — unresolved $ref
  - `datetime` string — Either a date-time or an interval, open or closed. Date and time expressions adhere to RFC 3339. Open intervals are expressed using double-dots. Examples: * A date-time: "2018-02-12T23:20:50Z" * A closed interval: "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z" * Open intervals: "2018-02-12T00:00:00Z/.." or "../2018-03-18T12:31:12Z" Only features that have a temporal property that intersects the value of `datetime` are selected. If a feature has multiple temporal properties, it is the decision of the server whether only a single temporal property is used to determine the extent or all relevant temporal properties.
  - `intersects` GeometryGeoJSON — unresolved $ref
  - `collections` string[] — Array of Collection IDs to include in the search for items. Only Item objects in one of the provided collections will be searched.
  - `ids` string[] — Array of Item ids to return.
  - `limit` integer — The optional limit parameter limits the number of items that are presented in the response document. If the limit parameter value is greater than advertised limit maximum, the server must return the maximum possible number of items, rather than responding with an error. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items must not be counted. Minimum = 1. Maximum = 10000. Default = 10.

## Response `200`

A feature collection.

## Other responses

- `4XX` — unresolved $ref
- `5XX` — unresolved $ref

## Changes

- **2022-08-24** `2f6b8a4fb1b2` — 2 breaking, 1 warning
  - added `#/components/schemas/bboxFilter, #/components/schemas/datetimeFilter, #/components/schemas/intersectsFilter, #/components/schemas/collectionsFilter, #/components/schemas/idsFilter, #/components/schemas/limitFilter` to the request body `allOf` list
  - the request's body type changed from no type to `object`
  - removed `#/components/schemas/searchBody, #/components/schemas/searchBody, #/components/schemas/searchBody, #/components/schemas/searchBody` from the request body `allOf` list
- **2021-05-14** `47a143aa3bcf` — 1 breaking, 1 warning
  - added `#/components/schemas/searchBody` to the request body `allOf` list
  - removed `#/components/schemas/searchBody` from the request body `allOf` list
- **2021-05-14** `192a3d9ea81c` — 1 breaking, 1 warning
  - added `#/components/schemas/searchBody` to the request body `allOf` list
  - removed `#/components/schemas/searchBody` from the request body `allOf` list
- **2021-05-10** `84091d2db548` — 1 breaking, 1 warning
  - added `#/components/schemas/searchBody` to the request body `allOf` list
  - removed `#/components/schemas/searchBody` from the request body `allOf` list
- …earlier changes not shown

[Full history](https://skmtc.dev/radiantearth/apis/stac-api-item-search/changes/search/post.md)

---

[API](https://skmtc.dev/radiantearth/apis/stac-api-item-search.md) · [All operations](https://skmtc.dev/radiantearth/apis/stac-api-item-search/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/radiantearth/stac-api-item-search/revisions/033dc0000638/schema)