메뉴

오디언스 목록 조회하기

상태를 변경하려면 Token을 사용해야 합니다. 자세한 내용은 Token을 확인하세요.

Audience 정보 목록을 조회합니다. 한 번에 최대 500개의 Audience 패키지 정보를 가져올 수 있습니다.

요청 주소

https://ss-api.mintegral.com/api/open/v1/audience

요청 메서드

GET

요청 예시

json Copy

GET /api/open/v1/audience?ta_ids=123,456,789&ta_name=xyz&platform=2&limit=10&page=1 HTTP/1.1
Host: ss-api.mintegral.com

요청 파라미터

PS: 기본값이 "--"인 경우, 해당 필드에 기본값이 없음을 의미합니다.

Fields	Type	Explanations	Default Value	Value Examples
ta_ids `Optional`	string	해당 Audience ID의 데이터를 조회합니다. 여러 ID는 쉼표로 구분합니다.	--	123,456,789
ta_name `Optional`	string	Audience 이름입니다. 퍼지 검색을 지원합니다.	--	xyz
platform `Optional`	int	Audience 집행 플랫폼 1:Android,2:iOS,3:mix	--	2
limit `Optional`	int	페이지당 제한 수 최대값: 500 >500이면 500을 반환합니다.	10	10
page `Optional`	int	페이지	1	1

응답

Fields	Type	Explanations
code	int	200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg	string	성공 시 “success”를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data	json	성공 시 Audience 정보를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
page	int	현재 페이지
limit	int	현재 페이지 제한 수
current_total	int	현재 페이지 총 개수
total	int	총 개수
list	array<json>
ta_id	int	Audience ID
platform	int	Audience 플랫폼
ta_name	int	Audience 이름
ta_type	int	Audience 유형 1:Upload
device_type	string	디바이스 유형 1:IMEI ,2:IDFA, 3:GAID, 4:OAID, 6:IMEI_MD5, 7:IDFA_MD5, 8:GAID_MD5, 9:OAID_MD5, 10:IDFV, 11:IDFV_MD5
area_type	int	데이터 클러스터 1: 중국 본토 외 지역, 2: 중국 본토
ctime	int	생성 시간(타임스탬프)
utime	int	업데이트 시간(타임스탬프)

응답 예시

json Copy

{
    "code": 200,
    "message": "success",
    "data": {
        "page": 1,
        "limit": 2,
        "current_total": 2,
        "total": 3,
        "list": [
            {
                "ta_id": 1147,
                "platform": 2,
                "ta_name": "12314154wtwtw-2-1704871621",
                "ta_type": 1,
                "device_type": "2,8,9",
                "area_type": 1,
                "ctime": 1704871629,
                "utime": 1704871631
            },
            {
                "ta_id": 1146,
                "platform": 2,
                "ta_name": "12314154wtwtw-2-1704870794",
                "ta_type": 1,
                "device_type": "2",
                "area_type": 1,
                "ctime": 1704870806,
                "utime": 1704870806
            }
        ]
    }
}

이전의

오디언스

오디언스 파일 업로드하기

최근 수정됨: 2026-08-06

개요