Get The Structured Market Intelligence Output For A Completed Query
GET
https://api.getcovent.com/api/v1/market-intelligence/queries/miq_123/resultsRetrieve the structured market intelligence output for a completed query.
How to Call
Use one of the examples below to call this endpoint from your own integration.
curl -X GET "https://api.getcovent.com/api/v1/market-intelligence/queries/miq_123/results" \
-H "Authorization: Bearer <API_KEY>" \
-H "Accept: application/json"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/jsonidstringRequired
id path parameter.
Example: miq_123Response
200application/jsonmarket_summaryobjectRequired
market_summary response field.
Example: {"market":"Phoenix, AZ","trend":"stable","median_days_on_market":23}ownership_breakdownobjectRequired
ownership_breakdown response field.
Example: {"owner_occupied_pct":61,"investor_owned_pct":39}pricing_metricsobjectRequired
pricing_metrics response field.
Example: {"median_price":392000,"median_price_per_sqft":248}inventory_metricsobjectRequired
inventory_metrics response field.
Example: {"active_inventory":812,"new_listings_30d":276}buyer_activityobjectRequired
buyer_activity response field.
Example: {"cash_share_pct":34,"institutional_buyer_pct":11}property_signalsobjectRequired
property_signals response field.
Example: {"distressed_share_pct":6,"price_drop_share_pct":18}Response Example
{
"market_summary": {
"market": "Phoenix, AZ",
"trend": "stable",
"median_days_on_market": 23
},
"ownership_breakdown": {
"owner_occupied_pct": 61,
"investor_owned_pct": 39
},
"pricing_metrics": {
"median_price": 392000,
"median_price_per_sqft": 248
},
"inventory_metrics": {
"active_inventory": 812,
"new_listings_30d": 276
},
"buyer_activity": {
"cash_share_pct": 34,
"institutional_buyer_pct": 11
},
"property_signals": {
"distressed_share_pct": 6,
"price_drop_share_pct": 18
}
}