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

# Get multiple creatives

> 소재를 검색합니다.



## OpenAPI

````yaml /openapi/adm.openapi.ko-0.2.2.json get /creatives
openapi: 3.1.0
info:
  description: >-
    ## 소개

    Data Management API는 광고 및 추천 시스템이 활용하는 **다양한 데이터를** 종합적으로 관리해, Decision API가
    정확하고 효율적으로 작동할 수 있도록 돕습니다.


    캠페인이나 지면을 신규 등록하고 수정·삭제하는 것은 물론, **로그 및 통계 분석을** 통해 시스템 운영에 필요한 인사이트를 확보합니다.
    이렇게 확보된 데이터와 통계는 Decision API에서 최적화된 광고·콘텐츠를 결정하는 데 활용되며, 전체 광고·추천 시스템의 성능
    향상에 이바지합니다.
  title: Data Management APIs
  version: 0.1.3
servers: []
security: []
tags:
  - name: Audience Targeting
  - description: >
      오디언스 관리 API를 사용하여 오디언스 관련 데이터를 통합할 수 있습니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Audience
  - description: >
      광고 타겟팅 및 성과 최적화를 위한 사용자 활동 로그 수집 API.


      활동 로그는 광고 상호작용 여부와 관계없이 모든 사용자의 상품 조회, 검색, 장바구니 추가, 구매 등 실제 사용자 행동을 기록합니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Activity Log
  - description: >
      오디언스 속성 API로 오디언스 속성 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Attribute
  - description: >
      오디언스 세그먼트 API로 오디언스 세그먼트 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Segment
  - description: >
      광고 타겟팅 및 성과 최적화를 위한 사용자 활동 로그 수집 API.


      활동 로그는 광고 상호작용 여부와 관계없이 모든 사용자의 상품 조회, 검색, 장바구니 추가, 구매 등 실제 사용자 행동을 기록합니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Activity Log
  - description: >
      오디언스 속성 API로 오디언스 속성 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Attribute
  - description: >
      오디언스 세그먼트 API로 오디언스 세그먼트 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Segment
  - description: 분석 API는 대시보드 및 A2 메트릭 데이터에 액세스할 수 있습니다.
    name: Analytic
  - description: >-
      결제 정보를 관리하는 결제 API입니다.

      A2는 리테일 플랫폼에서 사용하는 결제 시스템과 통합되도록 구성되어 있습니다.


      결제를 통합하려면 먼저 외부 채널을 등록해야 합니다.

      결제 시스템과 통합하는 방법에 대한 자세한 내용은 [외부 채널
      페이지](https://docs.aiderx.io/guides/about-a2/en/external-channel)를 참고하세요.
    name: Billing
  - description: |
      캠페인 데이터를 관리하는 캠페인 API입니다.

      관련 문서:
      - [Campaign](https://docs.aiderx.io/guides/about-a2/en/campaign)
    name: Campaign
  - description: |
      소재 및 관련 리소스를 관리하는 크리에이티브 API입니다.

      관련 문서:
      - [Creative](https://docs.aiderx.io/guides/about-a2/en/creative)
    name: Creative
  - description: |
      배정 및 관련 리소스를 관리하는 할당 API입니다.

      관련 문서:
      - [Allocation](https://docs.aiderx.io/guides/about-a2/en/allocation)
    name: Allocation
  - description: |
      미디어 라이브러리 및 관련 리소스를 관리하는 미디어 라이브러리 API입니다.

      관련 문서:
      - [Media Library](https://docs.aiderx.io/guides/about-a2/en/media-library)
    name: Media Library
  - description: |
      소재 및 관련 리소스를 관리하는 크리에이티브 API입니다.

      관련 문서:
      - [Creative](https://docs.aiderx.io/guides/about-a2/en/creative)
    name: Creative
  - description: |
      배정 및 관련 리소스를 관리하는 할당 API입니다.

      관련 문서:
      - [Allocation](https://docs.aiderx.io/guides/about-a2/en/allocation)
    name: Allocation
  - description: |
      미디어 라이브러리 및 관련 리소스를 관리하는 미디어 라이브러리 API입니다.

      관련 문서:
      - [Media Library](https://docs.aiderx.io/guides/about-a2/en/media-library)
    name: Media Library
  - description: >
      카탈로그 관리 API는 카탈로그 및 관련 리소스를 관리하는 기능을 제공합니다.


      관련 문서:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Catalog
  - description: |
      지면 관리 API는 지면 및 관련 리소스를 관리하는 기능을 제공합니다.

      관련 문서:
      - [Placement](https://docs.aiderx.io/guides/about-a2/en/placement)
    name: Placement
  - description: |
      지면 카탈로그는 지면 정보를 구조화된 “광고 제품”으로 변환하여 광고주에게 쉽게 제시할 수 있습니다.

      관련 문서:
      - 업데이트 예정
    name: Placement Catalog
  - description: |
      지면 카탈로그는 지면 정보를 구조화된 “광고 제품”으로 변환하여 광고주에게 쉽게 제시할 수 있습니다.

      관련 문서:
      - 업데이트 예정
    name: Placement Catalog
  - description: >
      시스템 레벨 설정 및 자산(로고 및 구성 값)에 액세스하고 관리할 수 있는 시스템 API입니다.


      관련 문서:

      - [Yield Optimization
      Settings](https://docs.aiderx.io/guides/about-a2/en/yield-optimization)
    name: System
  - description: >
      인증 및 사용자 관리 기능을 제공합니다.


      관련 문서:

      - [Account and
      Budget](https://docs.aiderx.io/guides/about-a2/en/account-and-budget)
    name: Auth and User
  - description: 라이선스 관리 기능을 제공합니다.
    name: License
  - description: 라이선스 관리 기능을 제공합니다.
    name: License
paths:
  /creatives:
    get:
      tags:
        - Creative
      summary: Get multiple creatives
      description: 소재를 검색합니다.
      operationId: handle_get_creatives_creatives_get
      parameters:
        - description: 소재 소유자
          in: query
          name: owner_id
          required: false
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            description: 소재 소유자
            title: Owner Id
        - description: 캠페인 ID
          in: query
          name: cid
          required: false
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            description: 캠페인 ID
            title: Cid
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/CreativeReadSchema'
                title: Response Handle Get Creatives Creatives Get
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - OAuth2PasswordBearer: []
components:
  schemas:
    CreativeReadSchema:
      description: 소재 조회 스키마
      properties:
        banner:
          $ref: '#/components/schemas/Banner'
          default:
            ext: {}
            img: ''
            link:
              ext: {}
              url: ''
        cid:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          description: 소재가 사용될 캠페인의 id
          title: Cid
        created_at:
          description: 소재의 생성시간
          format: date-time
          title: Created At
          type: string
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: 소재 설명
          title: Description
        height:
          anyOf:
            - type: integer
            - type: 'null'
          default: 0
          description: 소재의 높이
          title: Height
        id:
          description: 소재 id
          format: uuid
          title: Id
          type: string
        name:
          description: 소재 이름
          title: Name
          type: string
        native:
          $ref: '#/components/schemas/Native'
          default:
            ext: {}
            link:
              ext: {}
              url: ''
        'no':
          description: 소재 번호
          title: 'No'
          type: integer
        owner_id:
          description: 소재의 소유자 id
          format: uuid
          title: Owner Id
          type: string
        status:
          default: inactive
          description: 소재의 상태
          enum:
            - active
            - inactive
          title: Status
          type: string
        type:
          description: 소재 유형
          enum:
            - banner
            - video
            - native
          title: Type
          type: string
        updated_at:
          description: 소재의 수정시간
          format: date-time
          title: Updated At
          type: string
        video:
          $ref: '#/components/schemas/a2_adm__db__models__creative__Video'
          default:
            adm: ''
            ctype: 2
            dur: 0
            ext:
              cdn: ''
              linear: 1
              link:
                ext: {}
                url: ''
              url: ''
            mime: ''
        width:
          anyOf:
            - type: integer
            - type: 'null'
          default: 0
          description: 소재의 너비
          title: Width
      required:
        - type
        - name
        - id
        - 'no'
        - owner_id
      title: CreativeReadSchema
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    Banner:
      description: 배너 이미지 및 추가 옵션
      properties:
        ext:
          default: {}
          title: Ext
          type: object
        img:
          default: ''
          description: 이미지 URL
          title: Img
          type: string
        link:
          $ref: '#/components/schemas/Link'
      title: Banner
      type: object
    Native:
      description: 네이티브 소재 및 추가 옵션
      properties:
        ext:
          default: {}
          title: Ext
          type: object
        link:
          $ref: '#/components/schemas/Link'
      title: Native
      type: object
    a2_adm__db__models__creative__Video:
      description: 비디어 소재 정보 및 추가 옵션
      properties:
        adm:
          default: ''
          description: VAST 마크업
          title: Adm
          type: string
        ctype:
          default: 2
          description: 비디오 소재의 세부유형
          title: Ctype
          type: integer
        dur:
          default: 0
          description: 재생시간
          title: Dur
          type: integer
        ext:
          title: Ext
          type: object
        mime:
          default: ''
          description: 비디오 소재의 mime-type
          title: Mime
          type: string
      title: Video
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    Link:
      description: 소재 URL 및 추가 옵션
      properties:
        ext:
          title: Ext
          type: object
        url:
          default: ''
          description: 소재 URL
          title: Url
          type: string
      title: Link
      type: object
  securitySchemes:
    OAuth2PasswordBearer:
      flows:
        password:
          scopes: {}
          tokenUrl: auth/jwt/login
      type: oauth2

````