GroundTruth

GroundTruth Static API

The Static API from GroundTruth — 12 operation(s) for static.

GitHub OpenAPI

Operations 12

GET /static/account_verticals Get Account Verticals #
GET /static/audio/podcast_topics Get Audio Podcast Topics #
GET /static/audio/streaming_genres Get Audio Streaming Genres #
GET /static/mobile_carriers Get Carriers #
GET /static/cities Get Cities #
GET /static/streaming_video/content_categories Get Streaming Video Content Categories #
GET /static/streaming_video/premium_ctv_categories Get Streaming Video Premium Ctv Categories #
GET /static/dmas Get Dmas #
GET /static/publisher_categories Get Publisher Categories #
GET /static/states Get States #
GET /static/iab_categories Get Iab Categories #
GET /static/publishers Get Publishers #

Documentation

📖
Documentation
https://api-docs.groundtruth.com/
📖
APIReference
https://api-docs.groundtruth.com/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/authentication/groundtruth-authentication.yml
📖
Documentation
https://reporting.groundtruth.com/api
📖
APIReference
https://reporting.groundtruth.com/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/openapi/groundtruth-static-api-openapi.yml

Other Resources

🔗
Console
https://api-public.groundtruth.com/docs
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/conventions/groundtruth-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/errors/groundtruth-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/groundtruth/refs/heads/main/data-model/groundtruth-data-model.yml

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/groundtruth-static-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

groundtruth-static-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Ads Manager Static API
  description: Ads Manager API
  version: 1.0.0
servers:
- url: https://api-public.groundtruth.com
  description: Production
tags:
- name: Static
paths:
  /static/account_verticals:
    get:
      tags:
      - Static
      summary: Get Account Verticals
      description: Gets all account verticals
      operationId: get_account_verticals
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountVerticalsModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
  /static/audio/podcast_topics:
    get:
      tags:
      - Static
      summary: Get Audio Podcast Topics
      description: Gets all targetable audio podcast topics
      operationId: get_audio_podcast_topics
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudioPodcastTopicsModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
  /static/audio/streaming_genres:
    get:
      tags:
      - Static
      summary: Get Audio Streaming Genres
      description: Gets all targetable audio streaming genres
      operationId: get_audio_streaming_genres
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudioStreamingGenresModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
  /static/mobile_carriers:
    get:
      tags:
      - Static
      summary: Get Carriers
      description: Gets all targetable carriers for your account's country
      operationId: get_carriers
      security:
      - api-key: []
      - user-id: []
      - session: []
      parameters:
      - name: tenant_id
        in: query
        required: true
        schema:
          type: integer
          title: Tenant Id
      - name: account_id
        in: query
        required: true
        schema:
          type: integer
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MobileCarriersModel'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Internal Server Error
  /static/cities:
    get:
      tags:
      - Static
      summary: Get Cities
      description: Gets all targetable cities for your account's country
      operationId: get_cities
      security:
      - api-key: []
      - user-id: []
      - session: []
      parameters:
      - name: tenant_id
        in: query
        required: true
        schema:
          type: integer
          title: Tenant Id
      - name: account_id
        in: query
        required: true
        schema:
          type: integer
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CitiesModel'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Internal Server Error
  /static/streaming_video/content_categories:
    get:
      tags:
      - Static
      summary: Get Streaming Video Content Categories
      description: Gets all targetable streaming video content categories
      operationId: get_streaming_video_content_categories
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StreamingVideoContentCategoriesModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
  /static/streaming_video/premium_ctv_categories:
    get:
      tags:
      - Static
      summary: Get Streaming Video Premium Ctv Categories
      description: Gets all targetable CTV premium categories
      operationId: get_streaming_video_premium_ctv_categories
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CTVPremiumCategoriesModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
  /static/dmas:
    get:
      tags:
      - Static
      summary: Get Dmas
      description: Gets all targetable DMAs
      operationId: get_dmas
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DMAsModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
  /static/publisher_categories:
    get:
      tags:
      - Static
      summary: Get Publisher Categories
      description: Gets all targetable publisher categories
      operationId: get_publisher_categories
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherCategoriesModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
  /static/states:
    get:
      tags:
      - Static
      summary: Get States
      description: Gets all targetable states for your account's country
      operationId: get_states
      security:
      - api-key: []
      - user-id: []
      - session: []
      parameters:
      - name: tenant_id
        in: query
        required: true
        schema:
          type: integer
          title: Tenant Id
      - name: account_id
        in: query
        required: true
        schema:
          type: integer
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatesModel'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Internal Server Error
  /static/iab_categories:
    get:
      tags:
      - Static
      summary: Get Iab Categories
      description: Gets IAB categories
      operationId: get_iab_categories
      parameters:
      - name: search
        in: query
        required: false
        schema:
          type: string
          description: Search IAB categories based on name or category
          default: ''
          title: Search
        description: Search IAB categories based on name or category
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IABCategoriesResponseModel'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Internal Server Error
  /static/publishers:
    get:
      tags:
      - Static
      summary: Get Publishers
      description: Gets available publishers for a campaign
      operationId: get_publishers
      security:
      - api-key: []
      - user-id: []
      - session: []
      parameters:
      - name: tenant_id
        in: query
        required: true
        schema:
          type: integer
          title: Tenant Id
      - name: campaign_id
        in: query
        required: true
        schema:
          type: integer
          title: Campaign Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublishersModel'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseModel'
          description: Internal Server Error
components:
  schemas:
    AudioStreamingGenresModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/app__api__routes__static__models__AudioStreamingGenreModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: AudioStreamingGenresModel
    app__api__routes__static__models__CTVPremiumCategoryModel:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        apps:
          items:
            $ref: '#/components/schemas/CTVAppModel'
          type: array
          title: Apps
      type: object
      required:
      - id
      - name
      - apps
      title: CTVPremiumCategoryModel
    CTVAppModel:
      properties:
        name:
          type: string
          title: Name
        logo_url:
          type: string
          title: Logo Url
      type: object
      required:
      - name
      - logo_url
      title: CTVAppModel
    ErrorModel:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
        fields:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Fields
      type: object
      required:
      - code
      - message
      - fields
      title: ErrorModel
    app__api__routes__static__models__AudioStreamingGenreModel:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        icon:
          type: string
          title: Icon
      type: object
      required:
      - id
      - name
      - icon
      title: AudioStreamingGenreModel
    AccountVerticalModel:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
      type: object
      required:
      - id
      - name
      title: AccountVerticalModel
    IABCategoriesResponseModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/IABCategoryModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: IABCategoriesResponseModel
    AccountVerticalsModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/AccountVerticalModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: AccountVerticalsModel
    CityModel:
      properties:
        name:
          type: string
          title: Name
        state_code:
          type: string
          title: State Code
      type: object
      required:
      - name
      - state_code
      title: CityModel
    app__api__routes__static__models__AudioPodcastTopicModel:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        icon:
          type: string
          title: Icon
        color:
          type: string
          pattern: ^[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$
          title: Color
          examples:
          - FFAA74
          - 01AB23CD
      type: object
      required:
      - id
      - name
      - icon
      - color
      title: AudioPodcastTopicModel
    CitiesModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/CityModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: CitiesModel
    PublisherCategoriesModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/app__api__routes__static__models__PublisherCategoryModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: PublisherCategoriesModel
    ErrorResponseModel:
      properties:
        errors:
          items:
            $ref: '#/components/schemas/ErrorModel'
          type: array
          title: Errors
      type: object
      required:
      - errors
      title: ErrorResponseModel
    DMAModel:
      properties:
        code:
          type: string
          title: Code
        name:
          type: string
          title: Name
      type: object
      required:
      - code
      - name
      title: DMAModel
    app__api__routes__static__models__StreamingVideoContentCategoryModel:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        icon:
          type: string
          title: Icon
      type: object
      required:
      - id
      - name
      - icon
      title: StreamingVideoContentCategoryModel
    PublishersModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/app__api__routes__static__models__PublisherModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: PublishersModel
    MobileCarrierModel:
      properties:
        code:
          type: string
          title: Code
        name:
          type: string
          title: Name
      type: object
      required:
      - code
      - name
      title: MobileCarrierModel
    app__api__routes__static__models__PublisherCategoryModel:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        icon:
          type: string
          title: Icon
      type: object
      required:
      - id
      - name
      - icon
      title: PublisherCategoryModel
    PublisherTier:
      oneOf:
      - const: 4
        title: EXCHANGE
      - const: 6
        title: CUSTOM
      type: integer
      enum:
      - 4
      - 6
      title: PublisherTier
      x-enum-varnames:
      - EXCHANGE
      - CUSTOM
    MobileCarriersModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/MobileCarrierModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: MobileCarriersModel
    app__api__routes__static__models__PublisherModel:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        tier:
          $ref: '#/components/schemas/PublisherTier'
      type: object
      required:
      - id
      - name
      - tier
      title: PublisherModel
    StateModel:
      properties:
        id:
          type: integer
          title: Id
        code:
          type: string
          title: Code
        name:
          type: string
          title: Name
      type: object
      required:
      - id
      - code
      - name
      title: StateModel
    AudioPodcastTopicsModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/app__api__routes__static__models__AudioPodcastTopicModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: AudioPodcastTopicsModel
    DMAsModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/DMAModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: DMAsModel
    StreamingVideoContentCategoriesModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/app__api__routes__static__models__StreamingVideoContentCategoryModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: StreamingVideoContentCategoriesModel
    StatesModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/StateModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: StatesModel
    IABCategoryModel:
      properties:
        id:
          type: integer
          title: Id
        category:
          type: string
          title: Category
        name:
          type: string
          title: Name
        children:
          anyOf:
          - items:
              $ref: '#/components/schemas/IABCategoryModel'
            type: array
          - type: 'null'
          title: Children
      type: object
      required:
      - id
      - category
      - name
      title: IABCategoryModel
    CTVPremiumCategoriesModel:
      properties:
        items:
          items:
            $ref: '#/components/schemas/app__api__routes__static__models__CTVPremiumCategoryModel'
          type: array
          title: Items
      type: object
      required:
      - items
      title: CTVPremiumCategoriesModel
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: x-gt-api-key
    user-id:
      type: apiKey
      in: header
      name: x-gt-user-id