Skip to content
getgeolens.com
GeoLens Docs

Search Post

POST
/stac/search
 
curl --request POST \
  --url https://example.com/stac/search \
  --header 'Content-Type: application/json' \
  --data '{ "bbox": [ -77.2, 38.7, -76.8, 39.1 ], "collections": [ "geolens-unassigned" ], "limit": 25 }'

STAC Item Search (POST with JSON body).

Authorizations

Section titled “ Authorizations ”

Request Bodyrequired

Section titled “ Request Bodyrequired ”
Media type application/json
StacSearchBody

JSON body for POST /search.

object
bbox
Any of:
Array<number>
datetime
Any of:
string
collections
Any of:
Array<string>
ids
Any of:
Array<string>
intersects
Any of:
object
key
additional properties
any
limit
Limit

Maximum number of items returned. Values above 200 are clamped to 200.

integer
default: 10 >= 1
offset
Offset

Number of items to skip for pagination.

integer
0

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Successful Response

Media type application/geo+json
StacItemCollectionResponse

Typed OpenAPI representation of a STAC ItemCollection.

object
type
Type
string
default: FeatureCollection
Allowed value: FeatureCollection
features
required
Features
Array<object>
StacItemResponse

A GeoJSON Feature conforming to the STAC Item specification.

object
type
Type
string
default: Feature
Allowed value: Feature
stac_version
required
Stac Version

STAC specification version.

string
stac_extensions
Stac Extensions

STAC extension schema URIs in use.

Array<string>
id
required
Id

Stable item identifier.

string
geometry
required
Any of:
GeoJSONGeometryCollection

A GeoJSON GeometryCollection (RFC 7946 §3.1.8).

Geometry collections carry geometries instead of coordinates. Only generic-geometry datasets accept them on write.

Nested collections are rejected because PostGIS cannot round-trip them through the GeoJSON boundary.

object
type
required
Type
string
Allowed value: GeometryCollection
geometries
required
Geometries
Array<object>
GeoJSONGeometry

A GeoJSON geometry object (RFC 7946).

object
type
required
Type
string
Allowed values: Point MultiPoint LineString MultiLineString Polygon MultiPolygon
coordinates
required
Coordinates
Array
bbox
Any of:
array
>= 4 items <= 4 items
properties
required
StacItemProperties

Core STAC Item properties plus extension-defined fields.

object
datetime
required
Any of:
string
start_datetime
Any of:
string
end_datetime
Any of:
string
title
Any of:
string
description
Any of:
string
key
additional properties
any
links
required
Links
Array<object>
StacLink

A single STAC link object.

object
href
required
Href

Target URL of the link.

string
rel
required
Rel

Link relation type (e.g. ‘self’, ‘root’, ‘parent’, ‘item’, ‘data’).

string
type
Any of:
string
method
Any of:
string
assets
required
Assets
object
key
additional properties
StacItemAsset

A STAC asset attached to an Item.

object
href
required
Href

URL of the asset resource.

string
type
Any of:
string
title
Any of:
string
description
Any of:
string
roles
Any of:
Array<string>
key
additional properties
any
collection
Any of:
string
key
additional properties
any
links
required
Links
Array<object>
StacLink

A single STAC link object.

object
href
required
Href

Target URL of the link.

string
rel
required
Rel

Link relation type (e.g. ‘self’, ‘root’, ‘parent’, ‘item’, ‘data’).

string
type
Any of:
string
method
Any of:
string
numberMatched
required
Numbermatched
integer
numberReturned
required
Numberreturned
integer
context
required
StacContext

Paging metadata emitted with STAC ItemCollections.

object
limit
required
Limit
integer
returned
required
Returned
integer
matched
required
Matched
integer
key
additional properties
any
key
additional properties
any

Example 

{
  "context": {
    "limit": 10,
    "matched": 0,
    "returned": 0
  },
  "features": [],
  "links": [],
  "numberMatched": 0,
  "numberReturned": 0,
  "type": "FeatureCollection"
}

400

Section titled “ 400 ”

Bad request — invalid query parameters or payload

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string

Example 

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

401

Section titled “ 401 ”

Unauthenticated — a credential was supplied and could not be resolved (expired, revoked, or malformed). Sending no credential at all is not an error on these operations; they answer anonymously with the public subset.

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string

Example 

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

404

Section titled “ 404 ”

Not found

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string

Example 

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

429

Section titled “ 429 ”

Too many requests — retry after the advertised interval

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string

Example 

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

Headers

Section titled “ Headers ”
Retry-After
integer

Seconds until the request may be retried

500

Section titled “ 500 ”

Internal server error

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string

Example 

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

503

Section titled “ 503 ”

Service unavailable — the database could not serve the request

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string

Example 

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}
Privacy Apache 2.0 getgeolens.com