Covent
Get HelpOpen in app
Docs navigation
Overview
Listings
Individuals
Offers
Walkthroughs
Market intelligence
Create A Market Intelligence Query For A Market, Geography, Or Search AreaGet Query Metadata, Processing Status, And Requested Output ConfigurationGet The Structured Market Intelligence Output For A Completed Query
Polaris

Market intelligence

Create A Market Intelligence Query For A Market, Geography, Or Search Area

POSThttps://api.getcovent.com/api/v1/market-intelligence/queries

Create a market intelligence query for a market, geography, or search area.

How to Call

Use one of the examples below to call this endpoint from your own integration.

curl -X POST "https://api.getcovent.com/api/v1/market-intelligence/queries" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "geography": {
    "type": "city",
    "value": "Phoenix",
    "state_code": "AZ"
  },
  "property_types": [
    "single_family",
    "duplex"
  ],
  "timeframe": {
    "days": 90
  },
  "filters": {
    "price_min": 150000,
    "price_max": 500000
  },
  "sections": [
    "market_summary",
    "pricing_metrics",
    "buyer_activity"
  ]
}'

Request

Review headers, parameters, and body fields before calling this endpoint.

AuthorizationstringRequired

Bearer token for the proposed external API contract.

Example: Bearer <API_KEY>
AcceptstringRequired

Response format header.

Example: application/json
Content-TypestringRequired

JSON request body header.

Example: application/json

geographyobjectRequired

geography request field.

Example: {"type":"city","value":"Phoenix","state_code":"AZ"}
property_typesarrayRequired

property_types request field.

Example: ["single_family","duplex"]
timeframeobjectRequired

timeframe request field.

Example: {"days":90}
filtersobjectRequired

filters request field.

Example: {"price_min":150000,"price_max":500000}
sectionsarrayRequired

sections request field.

Example: ["market_summary","pricing_metrics","buyer_activity"]

Response

200application/json

idstringRequired

id response field.

Example: miq_123
statusstringRequired

status response field.

Example: queued
geographyobjectRequired

geography response field.

Example: {"type":"city","value":"Phoenix","state_code":"AZ"}
timeframeobjectRequired

timeframe response field.

Example: {"days":90}
sectionsarrayRequired

sections response field.

Example: ["market_summary","pricing_metrics","buyer_activity"]
created_atstringRequired

created_at response field.

Example: 2026-04-17T20:00:00Z

Response Example

{
  "id": "miq_123",
  "status": "queued",
  "geography": {
    "type": "city",
    "value": "Phoenix",
    "state_code": "AZ"
  },
  "timeframe": {
    "days": 90
  },
  "sections": [
    "market_summary",
    "pricing_metrics",
    "buyer_activity"
  ],
  "created_at": "2026-04-17T20:00:00Z"
}