# 3004-Ad-CPPs

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /cpp/ad:
    post:
      summary: 3004-Ad-CPPs
      deprecated: false
      description: Query CPP ad records by country, category, and keyword.
      operationId: 3004_Ad_cpps
      tags:
        - II. List of Interfaces/3. ASA Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - CN
                category:
                  type: string
                  description: Category and keyword (required, choose one)
                  examples:
                    - '7014'
                keyword:
                  type: string
                  description: 'keyword '
                  examples:
                    - 加速器
                cppType:
                  type: string
                  description: 'cpp Type ex: ASA、ORGANIC'
                  examples:
                    - ASA
                dateRangeType:
                  type: string
                  description: Default Last 7 Days
                  examples:
                    - DAY_7
                limit:
                  type: string
                  description: Related keyword count
                  examples:
                    - TOP_200
              required:
                - category
                - cppType
              x-apifox-orders:
                - region
                - category
                - keyword
                - cppType
                - dateRangeType
                - limit
              x-apifox-ignore-properties: []
            example:
              region: CN
              category: ''
              keyword: 加速器
              cppType: ASA
              dateRangeType: DAY_7
              limit: TOP_200
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOAdCppVO'
              example:
                requestParam:
                  region: CN
                  category: ''
                  keyword: 加速器
                  cppType: ASA
                  dateRangeType: DAY_7
                  limit: TOP_200
                result:
                  appInfoMap:
                    '741292507':
                      appName: 小红书 – 你的生活兴趣社区
                      icon: >-
                        https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/4d/03/58/4d035872-ed76-5454-db0a-b5c608a510a3/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/88x88w.png
                  cpps:
                    - appId: '1244505010'
                      content:
                        - >-
                          https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/50/72/0e/50720e7a-b797-623f-1682-02fc6f019dbe/754342b4-025f-4a5d-b821-3dd4dbbbeeca_1.png/720x0w.png
                        - >-
                          https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/5c/99/68/5c996881-7f22-e1ac-af29-277a30be17eb/43434a58-2d53-4003-8489-13d1cb1f51a6_2.png/720x0w.png
                      firstOccurTime: null
                      lastOccurTime: null
                      keywords:
                        - keyword: steam
                          pop: 81
                        - keyword: pubg mobile
                          pop: 78
                creditsCost:
                  requestCredits: 0
                  baseCredits: 500
                  extraCredits: 0
                  totalCostCredits: 500
                next: null
          headers: {}
          x-apifox-name: ''
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/3. ASA Services
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038437-run
components:
  schemas:
    OpenApiBaseVOAdCppVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/AdCppQuery'
          description: Your request param.
        result:
          $ref: '#/components/schemas/AdCppVO'
          description: Your response.
        creditsCost:
          $ref: '#/components/schemas/OpenApiPointCostVO'
          description: Credits cost info.
        next:
          $ref: '#/components/schemas/PaginationInfo'
          description: Next page info
      x-apifox-orders:
        - requestParam
        - result
        - creditsCost
        - next
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    PaginationInfo:
      type: object
      properties:
        taskId:
          type: string
          description: Task ID
        pageKey:
          type: string
          description: Page Key
        totalCount:
          type: integer
          description: Total Count
          format: int64
        totalPages:
          type: integer
          description: Total Pages
          format: int64
      x-apifox-orders:
        - taskId
        - pageKey
        - totalCount
        - totalPages
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    OpenApiPointCostVO:
      type: object
      properties:
        requestCredits:
          type: integer
          description: ''
        baseCredits:
          type: integer
          description: ''
        extraCredits:
          type: integer
          description: ''
        totalCostCredits:
          type: integer
          description: ''
      x-apifox-orders:
        - requestCredits
        - baseCredits
        - extraCredits
        - totalCostCredits
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    AdCppVO:
      type: object
      properties:
        appInfoMap:
          $ref: '#/components/schemas/MapAppInfo'
          description: ''
        cpps:
          type: array
          items:
            $ref: '#/components/schemas/AdCppInfo'
            description: com.xiaoxi.openapi.model.vo.AdCppVO.AdCppInfo
          description: ''
      x-apifox-orders:
        - appInfoMap
        - cpps
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    AdCppInfo:
      type: object
      properties:
        appId:
          type: string
          description: ''
        content:
          type: array
          items:
            type: string
          description: ''
        firstOccurTime: &ref_0
          $ref: '#/components/schemas/Instant'
          description: ''
        lastOccurTime: *ref_0
        keywords:
          type: array
          items:
            $ref: '#/components/schemas/Keyword'
            description: com.xiaoxi.openapi.model.vo.AdCppVO.Keyword
          description: ''
      x-apifox-orders:
        - appId
        - content
        - firstOccurTime
        - lastOccurTime
        - keywords
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Keyword:
      type: object
      properties:
        keyword:
          type: string
          description: ''
        pop:
          type: integer
          description: ''
      x-apifox-orders:
        - keyword
        - pop
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Instant:
      type: object
      properties:
        seconds:
          type: integer
          description: The number of seconds from the epoch of 1970-01-01T00:00:00Z.
          format: int64
        nanos:
          type: integer
          description: >-
            The number of nanoseconds, later along the time-line, from the
            seconds field.

            This is always positive, and never exceeds 999,999,999.
      x-apifox-orders:
        - seconds
        - nanos
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    MapAppInfo:
      type: object
      properties:
        key:
          $ref: '#/components/schemas/key'
      x-apifox-orders:
        - key
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    key:
      type: object
      properties:
        appId:
          type: string
          description: ''
        appName:
          type: string
          description: ''
        icon:
          type: string
          description: ''
      x-apifox-orders:
        - appId
        - appName
        - icon
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    AdCppQuery:
      type: object
      properties:
        region:
          type: string
          description: ''
          examples:
            - US
        category:
          type: string
          description: ''
        keyword:
          type: string
          description: ''
          examples:
            - soul
        dateRangeType:
          type: string
          description: ''
          enum:
            - DAY_7
            - DAY_30
            - DAY_90
          x-apifox-enum:
            - value: DAY_7
              name: DAY_7
              description: DAY_7
            - value: DAY_30
              name: DAY_30
              description: DAY_30
            - value: DAY_90
              name: DAY_90
              description: DAY_90
          examples:
            - DAY_7
        limit:
          type: string
          description: ''
          enum:
            - TOP_200
            - ALL
          x-apifox-enum:
            - value: TOP_200
              name: TOP_200
              description: TOP_200
            - value: ALL
              name: ALL
              description: ALL
          examples:
            - TOP_200
      x-apifox-orders:
        - region
        - category
        - keyword
        - dateRangeType
        - limit
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    apikey-header-x-openapi-key:
      type: apiKey
      in: header
      name: x-openapi-key
servers:
  - url: https://api.foxdata.com/apiv1/open-api
    description: Api Server
security:
  - apikey-header-x-openapi-key: []

```