> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oviond.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Data

> Proxy a datasource data query to data.oviond.com



## OpenAPI

````yaml https://api.oviond.com/openapi.json post /v1/data/query
openapi: 3.1.0
info:
  title: Oviond Backend API
  version: 1.0.0
  description: Authentication, account management, billing, and media services for Oviond.
  x-logo:
    url: https://app.oviond.com/img/oviond-full-logo.svg
    altText: Oviond
servers:
  - url: https://api.oviond.com
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /v1/data/query:
    post:
      tags:
        - Data
      summary: Query Data
      description: Proxy a datasource data query to data.oviond.com
      operationId: query_data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DataQueryRequest'
            example:
              datasource_id: gadw
              client_id: cliAbc123
              date_range:
                current_start: '2026-06-01'
                current_end: '2026-06-30'
                previous_start: '2026-05-01'
                previous_end: '2026-05-31'
              metrics:
                - impressions
                - clicks
                - ctr
              dimensions:
                - DATE
              data_view: ACCOUNT
      responses:
        '200':
          description: Query result from upstream API
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataProxyResponse'
              example:
                success: true
                data:
                  current:
                    - DATE: '2026-06-01'
                      impressions: 312
                      clicks: 11
                      ctr: 3.52
                  currentSummary:
                    impressions: 9097
                    clicks: 331
                    ctr: 3.64
                  previous: []
                  previousSummary: {}
                  state: ACTIVE
                meta:
                  request_id: req_a1b2c3
        '502':
          description: Upstream API error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  schemas:
    DataQueryRequest:
      type: object
      properties:
        datasource_id:
          type: string
          enum:
            - advanced-web-ranking
            - ac
            - adroll
            - ahrefs
            - basecamp
            - brightlocal
            - call-rail
            - drip
            - keywords
            - sendin-blue
            - sendgrid
            - moosend
            - mailer-lite
            - pingdom
            - uptime-robot
            - piwik-pro
            - wordpress
            - pabbly-connect
            - ment
            - twilio
            - switchy
            - vimeo
            - pinterest
            - pinterest-ads
            - gtres
            - paypal
            - gps
            - gs
            - CUSTOM_IMPORT
            - CUSTOM_DATA
            - CALCULATION
            - GOALS
            - str
            - wistia
            - ca-mon
            - convertkit
            - woocommerce
            - xero
            - matomo
            - go-high-level
            - wcs
            - bing-webmaster-tools
            - pipedrive
            - salesforce
            - tiktok
            - tiktok-ads
            - twr
            - twr-ads
            - spf
            - ytbe
            - google-local-services-ads
            - klaviyo
            - gsh
            - ga4
            - lkdin-ads
            - lkdin-pg
            - mlchmp
            - inst-ads
            - inst
            - fb-ads
            - fb-pg
            - gmb
            - serpstat
            - hubspot
            - gadw
            - sem-rush
            - se-ranking
            - microsoft-ads
            - plausible
            - snapchat-ads
            - amazon-advertising
            - microsoft-clarity
            - serp-watch
            - vbout
            - moz
            - chatgpt-ads
          example: ga4
        client_id:
          type: string
          example: cliAbc123
        date_range:
          $ref: '#/components/schemas/DateRangeQuery'
        metrics:
          type: array
          items:
            type: string
          example:
            - sessions
            - pageviews
        dimensions:
          type: array
          items:
            type: string
          example:
            - DATE
        data_view:
          type: string
          example: OVERVIEW
        filters:
          type: array
          items:
            $ref: '#/components/schemas/DataFilter'
        timezone:
          allOf:
            - $ref: '#/components/schemas/IanaTimezone'
            - default: UTC
        advanced:
          type: object
          additionalProperties: {}
        extra:
          type: object
          additionalProperties: {}
      required:
        - datasource_id
        - client_id
        - date_range
        - metrics
        - dimensions
        - data_view
    DataProxyResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data: {}
        meta: {}
      required:
        - success
    DateRangeQuery:
      type: object
      properties:
        current_start:
          type: string
          example: '2026-03-01'
        current_end:
          type: string
          example: '2026-03-31'
        previous_start:
          type: string
          example: '2026-02-01'
        previous_end:
          type: string
          example: '2026-02-28'
      required:
        - current_start
        - current_end
    DataFilter:
      type: object
      properties:
        field:
          type: string
        operator:
          type: string
        value: {}
    IanaTimezone:
      type: string
      example: America/New_York
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: >-
        Oviond API key (prefix `oviond_`) sent as a Bearer token — the
        credential for REST/programmatic and headless integrations. Manage keys
        in Settings → API Keys. API keys do NOT authenticate the MCP endpoint
        (/mcp), which uses OAuth 2.1 + PKCE.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Supabase-issued JWT used by the Oviond web app session. External API
        consumers should authenticate with an Oviond API key (ApiKeyAuth)
        instead.

````