adcritter-com Reports API

The Reports API from adcritter-com — 9 operation(s) for reports.

Documentation GitHub OpenAPI

Operations 9

GET /v1/advertisers/{advertiserId}/reports/snapshot Get advertisers by advertiser id reports snapshot #

GET /v1/advertisers/{advertiserId}/reports/campaigns Get advertisers by advertiser id reports campaigns #

GET /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId} Get advertisers by advertiser id reports campaigns by campaign id #

GET /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId}/daily Get advertisers by advertiser id reports campaigns by campaign id daily #

GET /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId}/dimensions/{dimension} Get advertisers by advertiser id reports campaigns by campaign id dimensions by… #

GET /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId}/ads Get advertisers by advertiser id reports campaigns by campaign id ads #

GET /v1/advertisers/{advertiserId}/reports/summary Get advertisers by advertiser id reports summary #

GET /v1/advertisers/{advertiserId}/reports/media-assets Get advertisers by advertiser id reports media assets #

GET /v1/advertisers/{advertiserId}/reports/media-assets/{mediaAssetId} Get advertisers by advertiser id reports media assets by media asset id #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/adcritter-com/openapi/adcritter-com-reports-api-openapi.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/adcritter-com/json-schema/adcritter-com-campaign-create-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/adcritter-com/json-schema/adcritter-com-campaign-update-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/adcritter-com/json-schema/adcritter-com-plan-create-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/adcritter-com/json-schema/adcritter-com-plan-update-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/adcritter-com/json-schema/adcritter-com-media-asset-update-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/adcritter-com/json-schema/adcritter-com-geo-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/adcritter-com:adcritter-com-reports-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Adcritter Com Reports API
  version: v1
  description: 'Operations tagged Reports across 2 of this provider''s published API definitions: swagger.json, adcritter-com-openapi.json. Each path carries the servers of the definition it was published in.'
security:
- ApiKey: []
  Bearer: []
tags:
- name: Reports
paths:
  /v1/advertisers/{advertiserId}/reports/snapshot:
    get:
      tags:
      - Reports
      parameters:
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SnapshotResponseResponse'
      summary: Get advertisers by advertiser id reports snapshot
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsSnapshot
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/campaigns:
    get:
      tags:
      - Reports
      parameters:
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: page
        in: query
        schema:
          type: integer
          format: int32
          default: 1
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignsSummaryReportResponseResponse'
      summary: Get advertisers by advertiser id reports campaigns
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsCampaigns
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId}:
    get:
      tags:
      - Reports
      parameters:
      - name: campaignId
        in: path
        required: true
        schema:
          type: string
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignReportResponseResponse'
      summary: Get advertisers by advertiser id reports campaigns by campaign id
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsCampaignsByCampaignId
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId}/daily:
    get:
      tags:
      - Reports
      parameters:
      - name: campaignId
        in: path
        required: true
        schema:
          type: string
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignReportResponseResponse'
      summary: Get advertisers by advertiser id reports campaigns by campaign id daily
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsCampaignsByCampaignIdDaily
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId}/dimensions/{dimension}:
    get:
      tags:
      - Reports
      parameters:
      - name: campaignId
        in: path
        required: true
        schema:
          type: string
      - name: dimension
        in: path
        required: true
        schema:
          type: string
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignDimensionReportResponseResponse'
      summary: Get advertisers by advertiser id reports campaigns by campaign id dimensions by…
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsCampaignsByCampaignIdDimensionsByDimension
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/campaigns/{campaignId}/ads:
    get:
      tags:
      - Reports
      parameters:
      - name: campaignId
        in: path
        required: true
        schema:
          type: string
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdReportResponseResponse'
      summary: Get advertisers by advertiser id reports campaigns by campaign id ads
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsCampaignsByCampaignIdAds
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/summary:
    get:
      tags:
      - Reports
      parameters:
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdvertiserSummaryResponseResponse'
      summary: Get advertisers by advertiser id reports summary
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsSummary
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/media-assets:
    get:
      tags:
      - Reports
      parameters:
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaAssetReportListResponseResponse'
      summary: Get advertisers by advertiser id reports media assets
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsMediaAssets
      x-operation-id-source: derived
  /v1/advertisers/{advertiserId}/reports/media-assets/{mediaAssetId}:
    get:
      tags:
      - Reports
      parameters:
      - name: mediaAssetId
        in: path
        required: true
        schema:
          type: string
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: advertiserId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaAssetDetailedReportResponseResponse'
      summary: Get advertisers by advertiser id reports media assets by media asset id
      x-summary-source: derived
      operationId: getV1AdvertisersByAdvertiserIdReportsMediaAssetsByMediaAssetId
      x-operation-id-source: derived
components:
  schemas:
    CampaignDimensionReportResponse:
      type: object
      properties:
        campaignId:
          type:
          - string
          - 'null'
        dimension:
          type:
          - string
          - 'null'
        dateRange:
          $ref: '#/components/schemas/DateRangeResponse'
        breakdowns:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/DimensionBreakdownResponse'
      additionalProperties: false
    AdvertiserSummaryResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/AdvertiserSummaryResponse'
      additionalProperties: false
    SnapshotResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/SnapshotResponse'
      additionalProperties: false
    SnapshotResponse:
      type: object
      properties:
        campaigns:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/SnapshotCampaignResponse'
      additionalProperties: false
    MediaAssetAdMetricsResponse:
      type: object
      properties:
        adId:
          type:
          - string
          - 'null'
        adName:
          type:
          - string
          - 'null'
        campaignId:
          type:
          - string
          - 'null'
        campaignName:
          type:
          - string
          - 'null'
        impressions:
          type: integer
          format: int64
        clicks:
          type: integer
          format: int64
        spend:
          type: number
          format: double
        ctr:
          type:
          - number
          - 'null'
          format: double
        cpc:
          type:
          - number
          - 'null'
          format: double
        cpm:
          type:
          - number
          - 'null'
          format: double
      additionalProperties: false
    CampaignsSummaryReportResponse:
      type: object
      properties:
        start:
          type: string
          format: date
        end:
          type: string
          format: date
        campaigns:
          $ref: '#/components/schemas/CampaignReportSummaryResponsePagedResponse'
      additionalProperties: false
    Error:
      type: object
      properties:
        code:
          type:
          - string
          - 'null'
        name:
          type:
          - string
          - 'null'
        message:
          type:
          - string
          - 'null'
        description:
          type:
          - string
          - 'null'
      additionalProperties: false
    AdvertiserSummaryResponse:
      type: object
      properties:
        dateRange:
          $ref: '#/components/schemas/DateRangeResponse'
        totals:
          $ref: '#/components/schemas/MetricsSummaryResponse'
        campaignCount:
          type: integer
          format: int32
        activeCampaignCount:
          type: integer
          format: int32
      additionalProperties: false
    DimensionBreakdownResponse:
      type: object
      properties:
        dimensionValue:
          type:
          - string
          - 'null'
        impressions:
          type: integer
          format: int64
        clicks:
          type: integer
          format: int64
        spend:
          type: number
          format: double
        ctr:
          type:
          - number
          - 'null'
          format: double
        cpc:
          type:
          - number
          - 'null'
          format: double
        cpm:
          type:
          - number
          - 'null'
          format: double
      additionalProperties: false
    AdMetricsResponse:
      type: object
      properties:
        adId:
          type:
          - string
          - 'null'
        adName:
          type:
          - string
          - 'null'
        impressions:
          type: integer
          format: int64
        clicks:
          type: integer
          format: int64
        spend:
          type: number
          format: double
        ctr:
          type:
          - number
          - 'null'
          format: double
        cpc:
          type:
          - number
          - 'null'
          format: double
        cpm:
          type:
          - number
          - 'null'
          format: double
      additionalProperties: false
    CampaignReportResponse:
      type: object
      properties:
        campaignId:
          type:
          - string
          - 'null'
        campaignName:
          type:
          - string
          - 'null'
        campaignType:
          type:
          - string
          - 'null'
        dateRange:
          $ref: '#/components/schemas/DateRangeResponse'
        totals:
          $ref: '#/components/schemas/MetricsSummaryResponse'
        timeSeries:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/TimeSeriesPointResponse'
      additionalProperties: false
    AdReportResponse:
      type: object
      properties:
        campaignId:
          type:
          - string
          - 'null'
        dateRange:
          $ref: '#/components/schemas/DateRangeResponse'
        ads:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/AdMetricsResponse'
      additionalProperties: false
    CampaignReportResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/CampaignReportResponse'
      additionalProperties: false
    CampaignsSummaryReportResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/CampaignsSummaryReportResponse'
      additionalProperties: false
    MediaAssetMetricsResponse:
      type: object
      properties:
        mediaAssetId:
          type:
          - string
          - 'null'
        mediaAssetName:
          type:
          - string
          - 'null'
        assetType:
          type:
          - string
          - 'null'
        adCount:
          type: integer
          format: int32
        impressions:
          type: integer
          format: int64
        clicks:
          type: integer
          format: int64
        spend:
          type: number
          format: double
        ctr:
          type:
          - number
          - 'null'
          format: double
        cpc:
          type:
          - number
          - 'null'
          format: double
        cpm:
          type:
          - number
          - 'null'
          format: double
      additionalProperties: false
    DateRangeResponse:
      type: object
      properties:
        start:
          type: string
          format: date
        end:
          type: string
          format: date
      additionalProperties: false
    SnapshotCampaignResponse:
      type: object
      properties:
        campaignId:
          type:
          - string
          - 'null'
        campaignName:
          type:
          - string
          - 'null'
        campaignType:
          type:
          - string
          - 'null'
        status:
          type:
          - string
          - 'null'
        pacing:
          type:
          - number
          - 'null'
          format: double
        todaySpend:
          type: number
          format: double
        intervalBudget:
          type: number
          format: double
        averageSpendPerDay:
          type: number
          format: double
        intervalStartDate:
          type: string
          format: date-time
        intervalEndDate:
          type: string
          format: date-time
        intervalCpm:
          type:
          - number
          - 'null'
          format: double
        intervalTotalClicks:
          type: integer
          format: int64
      additionalProperties: false
    AdReportResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/AdReportResponse'
      additionalProperties: false
    CampaignReportSummaryResponse:
      type: object
      properties:
        campaignId:
          type:
          - string
          - 'null'
        campaignName:
          type:
          - string
          - 'null'
        campaignType:
          type:
          - string
          - 'null'
        status:
          type:
          - string
          - 'null'
        totals:
          $ref: '#/components/schemas/MetricsSummaryResponse'
      additionalProperties: false
    MediaAssetReportListResponse:
      type: object
      properties:
        dateRange:
          $ref: '#/components/schemas/DateRangeResponse'
        mediaAssets:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/MediaAssetMetricsResponse'
      additionalProperties: false
    MediaAssetDetailedReportResponse:
      type: object
      properties:
        mediaAssetId:
          type:
          - string
          - 'null'
        mediaAssetName:
          type:
          - string
          - 'null'
        assetType:
          type:
          - string
          - 'null'
        impressions:
          type: integer
          format: int64
        clicks:
          type: integer
          format: int64
        spend:
          type: number
          format: double
        ctr:
          type:
          - number
          - 'null'
          format: double
        cpc:
          type:
          - number
          - 'null'
          format: double
        cpm:
          type:
          - number
          - 'null'
          format: double
        dateRange:
          $ref: '#/components/schemas/DateRangeResponse'
        ads:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/MediaAssetAdMetricsResponse'
        daily:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/TimeSeriesPointResponse'
      additionalProperties: false
    MetricsSummaryResponse:
      type: object
      properties:
        impressions:
          type: integer
          format: int64
        clicks:
          type: integer
          format: int64
        spend:
          type: number
          format: double
        uniqueViewers:
          type: integer
          format: int64
        ctr:
          type:
          - number
          - 'null'
          format: double
        cpc:
          type:
          - number
          - 'null'
          format: double
        cpm:
          type:
          - number
          - 'null'
          format: double
      additionalProperties: false
    MediaAssetDetailedReportResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/MediaAssetDetailedReportResponse'
      additionalProperties: false
    CampaignReportSummaryResponsePagedResponse:
      type: object
      properties:
        items:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/CampaignReportSummaryResponse'
        total:
          type: integer
          format: int32
        page:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int32
      additionalProperties: false
    TimeSeriesPointResponse:
      type: object
      properties:
        date:
          type:
          - string
          - 'null'
        impressions:
          type: integer
          format: int64
        clicks:
          type: integer
          format: int64
        spend:
          type: number
          format: double
        uniqueViewers:
          type: integer
          format: int64
        ctr:
          type:
          - number
          - 'null'
          format: double
        cpc:
          type:
          - number
          - 'null'
          format: double
        cpm:
          type:
          - number
          - 'null'
          format: double
      additionalProperties: false
    CampaignDimensionReportResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/CampaignDimensionReportResponse'
      additionalProperties: false
    MediaAssetReportListResponseResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          readOnly: true
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Error'
        data:
          $ref: '#/components/schemas/MediaAssetReportListResponse'
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      description: 'API key authentication. Prefix: ac_live_'
      name: X-Api-Key
      in: header
    Bearer:
      type: http
      description: JWT Bearer token authentication via Auth0.
      scheme: bearer
      bearerFormat: JWT
x-refined-from:
- swagger.json
- adcritter-com-openapi.json