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.
Updated about 21 hours ago
