Content API Common Tasks

This article covers common tasks that work in the same way on both Content API searches: by address and by parcel. You can add the fields shown to any search body.

Get content from a date range

"since": "2025-01-01",
"until": "2025-12-31"

Dates are YYYY-MM-DD, or relative to today: 10D (days), 5M (months), 1Y (years). Content is available from the last 2 years, so an earlier since is treated as 2 years ago and an until older than that returns 404 No coverage available.

Get imagery and AI features in one search

"resources": [
  { "namespace": "raster", "type": "vert" },
  { "namespace": "ai", "type": "vector_prediction" }
]

Your subscription must include AI content. If it doesn't, the whole search fails with 403 Access forbidden, including the imagery.

Get only released AI content

{ "namespace": "ai", "type": "vector_prediction",
  "selectors": { "releaseStatus": "ga" } }

Get one capture you have accessed earlier

{ "namespace": "raster", "type": "vert",
  "selectors": { "surveyId": "4917c780-facc-11e8-b671-33ff07a8dfbe" } }

Use the surveyId from an earlier response.

Get only content that covers the whole area

"overlap": "full"

By default, partial ; you also get content that covers only part of the property or area.

Get every page of results

A search returns up to limit resources (20 by default, up to 300). If there are more, the response includes a cursor. Send the cursor exactly as you received it. Getting the next page doesn’t use another credit or any of your allowance.

"limit": 100,
"cursor": "74686973206973206D65616E7420746F..."

Send the cursor exactly as you received it. Searching the same property again to get the next page doesn't use another credit.

Download every tile of a large property

A staticmap link returns one tile of up to 4096 x 4096 pixels. A resource's attributes.scale says how many tiles cover the property: widthInTiles columns and heightInTiles rows. Request each tile by filling {tileX} from 0 to widthInTiles - 1 and {tileY} from 0 to heightInTiles - 1, using the same token for all of them. See Static map tiles in the Content API handbook page.


Did this page help you?