---
title: "Unified Query"
method: POST
path: "/api/v1/data/query"
tags: ["Unified Data Query"]
---

# Unified Query

`POST /api/v1/data/query`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/data/query`
- Auth: none declared

Cross-connector unified query — query multiple data sources at once.

The premium "PublicData Oracle" endpoint. Fetches data from multiple
connectors in parallel and optionally runs cross-connector ML enrichment.
**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

Example request:
```json
{
    "connectors": ["entity", "economic"],
    "entity_cik": "0000320193",
    "include_risk": true,
    "economic_series": ["GDP", "FEDFUNDS"],
    "include_forecast": true,
    "include_ml_enrichment": true
}
```

## Query parameters

- `x_api_key` string, nullable

## Request body

- UnifiedQueryRequest: Cross-connector query request.
  - `connectors` string[], required: Which connectors to query: 'entity', 'economic', or both
  - `entity_cik` string, nullable: CIK for entity lookup
  - `entity_search` string, nullable: Entity search query
  - `include_risk` boolean: Include ML risk score for entity
  - `economic_series` string[], nullable: FRED/BLS series IDs to fetch
  - `include_forecast` boolean: Include ML forecast
  - `forecast_horizon` integer
  - `include_ml_enrichment` boolean: Run cross-connector ML analysis

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)