STAC Catalog

This section explains the response structure when querying the STAC Root Catalog.

Access imagery and metadata offered from vendors namely Sentinel, Landsat, SkySat, ICEYE, Maxar, and more by the Space42 STAC API.

Endpoint

GET /public/stac/

Include the following header:

x-api-key: YOUR_API_KEY

Example Request (cURL)

curl -H "x-api-key: YOUR_API_KEY" "https://giq.ae/public/stac/"

Example Response (Sample)

{
  "stac_version": "1.0.0",
  "type": "Catalog",
  "id": "abe3ed5f-55a4-99be-5c6e-41a4506737d8",
  "title": "Space42 Catalogs",
  "description": "Welcome to Space42’s STAC Catalogs. Browse satellite data collections and imagery via STAC endpoints.",
  "conformsTo": [
    "https://api.stacspec.org/v1.0.0/core",
    "https://api.stacspec.org/v1.0.0/collections",
    "https://api.stacspec.org/v1.0.0/item-search",
    "https://api.stacspec.org/v1.0.0/item-search#fields",
    "https://api.stacspec.org/v1.0.0/item-search#sort",
    "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
  ],
  "links": [
    {
      "rel": "self",
      "href": "https://giq.ae/public/stac/catalogs/abe3ed5f-55a4-99be-5c6e-41a4506737d8",
      "type": "application/json",
      "title": "Root Catalog"
    },
    {
      "rel": "root",
      "href": "https://giq.ae/public/stac/",
      "type": "application/json",
      "title": "STAC Root Catalog"
    },
    {
      "rel": "search",
      "href": "https://giq.ae/public/stac/search",
      "type": "application/geo+json",
      "title": "STAC Item Search"
    },
    {
      "rel": "child",
      "href": "https://giq.ae/public/stac/catalogs/bae06009-98f7-e6bf-a8c3-3237b3268d2c",
      "type": "application/json",
      "title": "Child Catalog"
    },
    {
      "rel": "preview",
      "href": "https://i.imghippo.com/files/xKsJ9115CQg.jpg",
      "type": "image/jpeg",
      "title": "Preview"
    },
    {
      "rel": "about",
      "href": "https://space42.ai/",
      "type": "text/html",
      "title": "About Space42"
    }
  ]
}

Response Overview

Returns a STAC Catalog object with links to:

self
root
search
child catalogs

Response Fields

Field	Description	Example
`id`	Unique identifier for the root catalog	`abe3ed5f-55a4-99be-5c6e-41a4506737d8`
`title`	Human-readable title of the catalog	`Space42 Catalogs`
`type`	STAC object type	`Catalog`
`description`	Description of what the catalog contains	`Welcome to Space42’s STAC Catalogs...`
`stac_version`	STAC version used in the response	`1.0.0`
`links`	Array of links (see below for details)	`[self, root, search, child, preview, about]`

Response Links

Link Rel	Description	URL
`self`	Link to the current catalog	`https://giq.ae/public/stac/catalogs/abe3ed5f-55a4-99be-5c6e-41a4506737d8`
`root`	Link to the root of the catalog hierarchy	`https://giq.ae/public/stac/`
`search`	Link to the STAC Search endpoint	`https://giq.ae/public/stac/search`
`child`	Child catalogs available under this root	Various (e.g. `gIQ workspace`, `Satellite images`)
`preview`	Preview image	`https://i.imghippo.com/files/xKsJ9115CQg.jpg`
`about`	External description link	`https://space42.ai/`

Use Cases

List all child catalogs
Navigate to specific data providers
Launch STAC item search

Endpoint​

Example Request (cURL)​

Example Response (Sample)​

Response Overview​

Response Fields​

Response Links​

Use Cases​