# 1015-App-CPP Ad Creatives

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /app/cpp:
    post:
      summary: 1015-App-CPP Ad Creatives
      deprecated: false
      description: Query Apple CPP ad records for a specified app.
      operationId: 1015_Apps_cppAd Creative
      tags:
        - II. List of Interfaces/1. application Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - CN
                appId:
                  type: string
                  description: App ID
                  examples:
                    - '6746785267'
                cppType:
                  type: string
                  description: cpp Type.ex:ASA、ORGANIC
                  examples:
                    - ASA
                start:
                  type: string
                  description: >-
                    Start date (defaults to today). Optional; required if end
                    date is provided.
                  examples:
                    - '2025-06-24'
                end:
                  type: string
                  description: >-
                    End date (defaults to today). Optional; required if start
                    date is provided.
                  examples:
                    - '2025-09-24'
                limit:
                  type: integer
                  description: Related keyword count limit
                  examples:
                    - TOP_200
              required:
                - cppType
                - start
                - end
              x-apifox-orders:
                - region
                - appId
                - cppType
                - start
                - end
                - limit
              x-apifox-ignore-properties: []
            example:
              region: CN
              appId: '6746785267'
              cppType: ASA
              start: '2026-05-01'
              end: '2026-06-01'
              limit: TOP_200
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-apifox-refs:
                  01M1NT47AJV7KVB1CDS3JHAF7R:
                    $ref: '#/components/schemas/OpenApiBaseVOWanKaAppCppVO'
                    x-apifox-overrides: {}
                properties:
                  requestParam: &ref_0
                    $ref: '#/components/schemas/WanKaAppCppQuery'
                    description: Your request param.
                  result: &ref_1
                    $ref: '#/components/schemas/WanKaAppCppVO'
                    description: Your response.
                  creditsCost: &ref_2
                    $ref: '#/components/schemas/OpenApiPointCostVO'
                    description: Credits cost info.
                  next: &ref_3
                    $ref: '#/components/schemas/PaginationInfo'
                    description: Next page info
                x-apifox-orders:
                  - 01M1NT47AJV7KVB1CDS3JHAF7R
                  - 01M1NT47AJ6E1H8BZ8VKASP0MR
                x-apifox-ignore-properties:
                  - requestParam
                  - result
                  - creditsCost
                  - next
              examples:
                '1':
                  summary: Success Example
                  value:
                    requestParam:
                      region: US
                      appId: '6746785267'
                      cppType: ASA
                      start: '2025-06-24'
                      end: '2025-09-24'
                      limit: 200
                    result:
                      appId: com.moye.shelter
                      icon: 链接地址
                      title: 神召守護隊
                      meta:
                        - url1
                        - url2
                      keywords:
                        - keyword: game
                          popularity: 23
                    creditsCost:
                      requestCredits: 0
                      baseCredits: 10
                      extraCredits: 0
                      totalCostCredits: 10
                    next: null
                '2':
                  summary: Success Example
                  value:
                    requestParam:
                      region: US
                      appId: '6746785267'
                      start: '2025-06-24'
                      end: '2025-09-24'
                      limit: 200
                    result:
                      appId: com.moye.shelter
                      icon: 链接地址
                      title: 神召守護隊
                      meta:
                        - url1
                        - url2
                      keywords:
                        - keyword: game
                          popularity: 23
                    creditsCost:
                      requestCredits: 0
                      baseCredits: 10
                      extraCredits: 0
                      totalCostCredits: 10
                    next: null
          headers: {}
          x-apifox-name: ''
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/1. application Services
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038418-run
components:
  schemas:
    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: ''
    WanKaAppCppVO:
      type: object
      properties:
        appId:
          type: string
          description: ''
        icon:
          type: string
          description: ''
        title:
          type: string
          description: ''
        meta:
          type: array
          items:
            type: string
          description: ''
        keywords:
          type: array
          items:
            $ref: '#/components/schemas/KeywordVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAppCppVO.KeywordVO
          description: ''
      x-apifox-orders:
        - appId
        - icon
        - title
        - meta
        - keywords
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    KeywordVO:
      type: object
      properties:
        keyword:
          type: string
          description: ''
        popularity:
          type: integer
          description: ''
      x-apifox-orders:
        - keyword
        - popularity
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WanKaAppCppQuery:
      type: object
      properties:
        region:
          type: string
          description: ''
          examples:
            - US
        appId:
          type: string
          description: ''
          examples:
            - ''
        start:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        end:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        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
          default: '{size: 200, point: 150}'
          examples:
            - 200
      x-apifox-orders:
        - region
        - appId
        - start
        - end
        - limit
      required:
        - appId
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    OpenApiBaseVOWanKaAppCppVO:
      type: object
      properties:
        requestParam: *ref_0
        result: *ref_1
        creditsCost: *ref_2
        next: *ref_3
      x-apifox-orders:
        - requestParam
        - result
        - creditsCost
        - next
      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: []

```
