플랫폼 가용성
- 24시간 상태
- 96%
최근 30일
제공 기능
각 TikTok 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 TikTok의 동영상, 계정 또는 인기 탭을 검색합니다. | 요청 1,000개당 $0.56 | 정상 |
프로필profile | 핸들로 TikTok 계정을 조회합니다. | 요청 1,000개당 $0.56 | 양호 · 상태 100% |
사용자 동영상user_videos | TikTok 크리에이터의 동영상을 캡션, 게시 시각, 좋아요·댓글·공유·조회 수와 함께 나열합니다. | 요청 1,000개당 $0.56 | 양호 · 상태 100% |
동영상 상세 정보video | URL로 TikTok 동영상 하나의 캡션, 작성자, 게시 시각, 좋아요·댓글·공유·조회 수를 가져옵니다. | 요청 1,000개당 $0.56 | 양호 · 상태 99% |
댓글comments | TikTok 동영상의 댓글을 읽어 옵니다. | 요청 1,000개당 $0.56 | 정상 |
해시태그hashtag | 해시태그로 게시된 TikTok 동영상을 탐색합니다. | 요청 1,000개당 $0.56 | 정상 |
팔로워followers | 핸들로 TikTok 계정의 팔로워·팔로잉·게시물·좋아요 총계를 확인하며, 반올림된 수치를 나타내는 정밀도 플래그가 함께 제공됩니다. | 요청 1,000개당 $0.56 | 정상 |
트랜스크립트transcript | URL로 TikTok 동영상의 트랜스크립트를 추출합니다. | 요청 1,000개당 $0.56 | 정상 |
숍 상품 검색shop_search | 키워드로 TikTok Shop 상품을 찾습니다. | 요청 1,000개당 $0.56 | 정상 |
숍 크리에이터 상세 정보shop_creator | 핸들로 TikTok Shop 크리에이터의 규모를 파악합니다. | 요청 1,000개당 $0.56 | 정상 |
해시태그 검색hashtag_search | keyword로 TikTok 해시태그를 검색합니다. | 요청 1,000개당 $0.81 | 정상 |
음악 검색music_search | 곡이나 아티스트 같은 keyword로 TikTok 사운드 라이브러리를 검색합니다. | 요청 1,000개당 $0.81 | 정상 |
음악 차트music_chart | TikTok 음악 차트 top50(기본값) 또는 viral50을 읽어 옵니다. | 요청 1,000개당 $0.81 | 정상 |
계정 검색user_search | keyword로 TikTok 계정을 TikTok 검색 순위대로 검색합니다. | 요청 1,000개당 $0.56 | 양호 · 상태 100% |
사운드를 사용한 동영상sound_videos | music_id나 사운드 페이지 링크로 특정 사운드를 사용한 TikTok 동영상을 나열합니다. | 요청 1,000개당 $0.56 | 정상 |
댓글 답글comment_replies | 동영상 url과 comments가 반환한 댓글 id로 TikTok 동영상의 댓글 하나에 달린 답글을 읽어 옵니다. | 요청 1,000개당 $0.56 | 정상 |
Shop 베스트셀러shop_hot_products | 동남아시아 또는 아시아 시장 한 곳의 TikTok Shop 베스트셀러 목록을 읽어 옵니다. | 요청 1,000개당 $0.81 | 정상 |
Shop 카테고리별 상품shop_category_products | 선택한 시장에서 category_id(예: 뷰티·퍼스널 케어는 601450)로 TikTok Shop 카테고리 하나에 속한 상품을 나열합니다. | 요청 1,000개당 $0.81 | 정상 |
팔로잉following | 핸들로 TikTok 사용자가 팔로우하는 계정을 나열합니다. | 요청 1,000개당 $0.64 | 정상 |
동영상 다운로드 링크video_download | url로 TikTok 동영상 하나의 워터마크 없는 다운로드 링크를 가져옵니다. | 요청 1,000개당 $0.64 | 정상 |
라이브 룸live_room | 핸들로 TikTok 계정이 지금 라이브 중인지 확인합니다. | 요청 1,000개당 $0.81 | 정상 |
Shop 스토어 상품shop_products | 선택한 시장에서 shop_id나 상점 링크로 TikTok Shop 내 한 상점의 상품을 나열합니다. | 요청 1,000개당 $0.81 | 정상 |
Shop 상품 리뷰shop_product_reviews | product_id나 상품 링크로 TikTok Shop 상품 하나의 구매자 리뷰를 읽어 옵니다. | 요청 1,000개당 $0.76 | 정상 |
인기 급상승 해시태그trending_hashtags | 시장 한 곳에서 최근 7일, 30일 또는 90일간의 TikTok 인기 급상승 해시태그를 읽어 오며, 필요하면 업종 하나로 좁힐 수 있습니다. | 요청 1,000개당 $0.81 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
TikTok 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 TikTok의 동영상, 계정 또는 인기 탭을 검색합니다. 캡션, 작성자, 좋아요·댓글·공유·조회 수를 받을 수 있습니다. 탭은 | keyword | content_type | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
profile프로필 핸들로 TikTok 계정을 조회합니다. 소개, 외부 링크, 팔로워·팔로잉·좋아요·동영상·친구 수, 생성일을 받을 수 있습니다. 프로필 URL이나 Douyin secUid가 아닌 핸들을 @ 포함 여부와 관계없이 사용하세요. 비공개 분석 데이터는 포함되지 않습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $0.56 | user_id · username · display_name · bio · url · external_url · follower_count · following_count · like_count · video_count · friend_count · is_verified · is_private · avatar_url · created_at · platform |
user_videos사용자 동영상 TikTok 크리에이터의 동영상을 캡션, 게시 시각, 좋아요·댓글·공유·조회 수와 함께 나열합니다. | username | min_likes, sort, until | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
video동영상 상세 정보 URL로 TikTok 동영상 하나의 캡션, 작성자, 게시 시각, 좋아요·댓글·공유·조회 수를 가져옵니다. 댓글과 트랜스크립트는 별도 액션으로 가져오며, 지표 이력은 보관되지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.56 | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
comments댓글 TikTok 동영상의 댓글을 읽어 옵니다. 좋아요 수, 답글 수, 답글 링크, 크리에이터의 좋아요 또는 고정 여부를 받을 수 있습니다. 최상위 댓글마다 답글은 최대 2개까지 포함되므로, 전체 대화 트리는 보장되지 않습니다. | url | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · text · author_username · author_id · like_count · reply_count · reply_to_id · is_reply · liked_by_author · pinned_by_author · posted_at · platform |
hashtag해시태그 해시태그로 게시된 TikTok 동영상을 탐색합니다. 각 동영상에는 캡션, 크리에이터, 좋아요·댓글·공유·조회 수가 포함됩니다. 태그는 # 포함 여부와 관계없이 전달할 수 있습니다. 일반 텍스트 검색이 아니며, 태그의 전체 규모나 추이를 측정하지 않습니다. | hashtag | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
followers팔로워 핸들로 TikTok 계정의 팔로워·팔로잉·게시물·좋아요 총계를 확인하며, 반올림된 수치를 나타내는 정밀도 플래그가 함께 제공됩니다. 팔로워 이름이 아닌 수치만 반환합니다. | username | channel | Sync 응답 | — | 요청 1,000개당 $0.56 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
transcript트랜스크립트 URL로 TikTok 동영상의 트랜스크립트를 추출합니다. 전체 텍스트를 제공하며, 타임스탬프가 있는 경우 구간별 텍스트도 제공합니다. 먼저 | url | — | Sync 응답 | — | 요청 1,000개당 $0.56 | id · url · text · segments · has_transcript · platform |
shop_search숍 상품 검색 키워드로 TikTok Shop 상품을 찾습니다. 가격, 정가, 판매량, 평점, 리뷰 수, 카테고리, 상점 이름을 받을 수 있습니다. | keyword | country, page | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · category · shop_name · image_url · platform |
shop_creator숍 크리에이터 상세 정보 핸들로 TikTok Shop 크리에이터의 규모를 파악합니다. 카테고리, 팔로워 수, 동영상 수, 홍보 상품, 판매량, 평균 조회수를 받을 수 있습니다. | username | country | Sync 응답 | — | 요청 1,000개당 $0.56 | id · username · url · name · text · avatar_url · country · categories · follower_count · video_count · product_count · sold_count · avg_views · platform |
hashtag_search해시태그 검색
| keyword | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | hashtag_id · hashtag_name · url · description · video_count · view_count · next_page_token · platform |
music_search음악 검색 곡이나 아티스트 같은 | keyword | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | id · url · title · author_name · album · duration_seconds · duration_sec · use_count · is_original · is_commercial · released_at · cover_image_url · audio_url · next_page_token · platform |
music_chart음악 차트 TikTok 음악 차트 | chart | Sync 응답 | 카탈로그 값: defaultLimit=50, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 50까지만 적용됩니다. | 요청 1,000개당 $0.81 | rank · id · url · title · author_name · album · language · duration_seconds · duration_sec · use_count · is_commercial · released_at · cover_image_url · audio_url · platform | |
user_search계정 검색
| keyword | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.56 | user_id · username · display_name · url · sec_uid · follower_count · following_count · like_count · video_count · is_verified · verified_label · avatar_url · is_live · next_page_token · platform |
sound_videos사운드를 사용한 동영상
| music_id | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.56 | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · platform · next_page_token |
comment_replies댓글 답글 동영상 | url, comment_id | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.56 | id · text · like_count · author_username · author_name · author_id · author_url · author_avatar_url · liked_by_author · is_reply · reply_to_id · reply_to_reply_id · language · posted_at · video_id · next_page_token · platform |
shop_hot_productsShop 베스트셀러 동남아시아 또는 아시아 시장 한 곳의 TikTok Shop 베스트셀러 목록을 읽어 옵니다. 지원 시장은 ID, JP, MX, MY(기본값), PH, SG, TH, VN입니다. 각 상품에는 | country | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다. | 요청 1,000개당 $0.81 | rank · id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform | |
shop_category_productsShop 카테고리별 상품 선택한 시장에서 | category_id | country, page_token | Sync 응답 | 호출 한 번에 최대 15행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform · next_page_token |
following팔로잉 핸들로 TikTok 사용자가 팔로우하는 계정을 나열합니다. 각 계정에는 사용자 ID, 핸들, 표시 이름, | username | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.64 | user_id · username · display_name · url · sec_uid · bio · follower_count · following_count · like_count · video_count · is_verified · verified_label · avatar_url · country · next_page_token · platform |
video_download동영상 다운로드 링크
| url | — | Sync 응답 | — | 요청 1,000개당 $0.64 | id · url · text · author_username · duration_seconds · duration_sec · video_url · video_backup_urls · width · height · size_bytes · hd_video_url · hd_width · hd_size_bytes · watermarked_video_url · audio_url · cover_image_url · image_urls · is_slideshow · expires_at · platform |
live_room라이브 룸 핸들로 TikTok 계정이 지금 라이브 중인지 확인합니다. 라이브 중이면 방 ID, 제목, 링크, 현재·최고·누적 시청자 수, 좋아요 수, 공유 수, 상품 수, 시작 시각, 커버, 만료되는 스트림 링크를 받을 수 있습니다. 라이브 중이 아닌 계정은 | username | — | Sync 응답 | — | 요청 1,000개당 $0.81 | username · display_name · user_id · is_live · room_id · url · title · viewer_count · peak_viewer_count · total_viewer_count · like_count · share_count · product_count · started_at · cover_image_url · stream_url · platform |
shop_productsShop 스토어 상품 선택한 시장에서 | shop_id | country, page_token | Sync 응답 | 다음 페이지를 가져오려면 next_page_token을 page_token으로 전달하고 다른 파라미터는 그대로 두세요. 페이지 하나당 호출 1회입니다. | 요청 1,000개당 $0.81 | id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform · next_page_token |
shop_product_reviewsShop 상품 리뷰
| product_id | country, page_token, rating, sort | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.76 | id · rating · rating_scale · text · posted_at · variant · is_verified_purchase · is_incentivized · image_urls · author_name · country · product_id · next_page_token · platform |
trending_hashtags인기 급상승 해시태그 시장 한 곳에서 최근 7일, 30일 또는 90일간의 TikTok 인기 급상승 해시태그를 읽어 오며, 필요하면 업종 하나로 좁힐 수 있습니다. 각 해시태그에는 | country, industry, page_token, time_window | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | rank · hashtag_id · hashtag_name · url · video_count · view_count · trend · next_page_token · platform |
TikTok search 파라미터는 각각 무엇을 의미하나요?
키워드로 TikTok의 동영상, 계정 또는 인기 탭을 검색합니다. 캡션, 작성자, 좋아요·댓글·공유·조회 수를 받을 수 있습니다. 탭은 content_type으로 선택합니다. 결과는 완전한 표본이 아니며, 순위 산정 방식은 공개되지 않습니다.
keyword필수search액션에서 공개 동영상을 검색할 검색어를 지정합니다.shop_search에서는 대신 별도의 데이터셋에 있는 TikTok Shop 상품을 검색합니다.content_type선택search액션에서 탭별로 결과를 필터링합니다. 허용 값은 동영상용video, 사용자용profile, 인기 콘텐츠용top입니다. 특정 작성자, 동영상, 해시태그 액션에서 이 파라미터를 지정해도 필터링이 적용된다고 보장하지 않으므로, 탭을 변경한 뒤에는 반환된 응답 객체와 필드를 확인하세요.허용 값:profiletopvideo
TikTok profile 파라미터는 각각 무엇을 의미하나요?
핸들로 TikTok 계정을 조회합니다. 소개, 외부 링크, 팔로워·팔로잉·좋아요·동영상·친구 수, 생성일을 받을 수 있습니다. 프로필 URL이나 Douyin secUid가 아닌 핸들을 @ 포함 여부와 관계없이 사용하세요. 비공개 분석 데이터는 포함되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- 공개 TikTok 핸들이며, 앞의
@는 붙여도 되고 생략해도 됩니다. DouyinsecUid토큰이나 프로필 전체 URL은 입력하지 마세요.followers에서는 팔로워 수를 반환하고,shop_creator에서는 지정한 시장의 크리에이터 커머스 정보를 조회합니다.TikTok: 사용자 이름과 표시 닉네임의 차이 — TikTok은 사용자 이름과 닉네임을 구분합니다. 사용자 이름은 @ 핸들과 프로필 URL을 구성하고, 닉네임은 다른 사용자에게 보이는 표시 이름입니다. 사용자 이름을 바꾸면 프로필 URL도 바뀝니다. · 확인일
TikTok user_videos 파라미터는 각각 무엇을 의미하나요?
TikTok 크리에이터의 동영상을 캡션, 게시 시각, 좋아요·댓글·공유·조회 수와 함께 나열합니다. min_likes로 필터링하거나, until로 게시일 상한을 지정하거나, sort로 최신순, 오래된순, 인기순 정렬을 할 수 있습니다. 임시 저장 게시물과 비공개 게시물은 포함되지 않습니다.
username필수- 공개 TikTok 핸들이며, 앞의
@는 붙여도 되고 생략해도 됩니다. DouyinsecUid토큰이나 프로필 전체 URL은 입력하지 마세요.followers에서는 팔로워 수를 반환하고,shop_creator에서는 지정한 시장의 크리에이터 커머스 정보를 조회합니다.TikTok: 사용자 이름과 표시 닉네임의 차이 — TikTok은 사용자 이름과 닉네임을 구분합니다. 사용자 이름은 @ 핸들과 프로필 URL을 구성하고, 닉네임은 다른 사용자에게 보이는 표시 이름입니다. 사용자 이름을 바꾸면 프로필 URL도 바뀝니다. · 확인일 min_likes선택- 최소 좋아요 수로 동영상을 필터링하는 숫자 기준값입니다. user_videos에만 적용되며, 작성자 팔로워 수나 댓글 좋아요 수는 필터링하지 않습니다.
sort선택user_videos액션에서 작성자 동영상 목록을 정렬합니다. 허용 값은newest,oldest,popular입니다.user_videos에만 적용됩니다.허용 값:newestoldestpopularuntil선택- 데이터 수집 시점이 아니라 동영상 게시 시점의 날짜 상한을 설정합니다. user_videos에만 적용됩니다.
TikTok video 파라미터는 각각 무엇을 의미하나요?
URL로 TikTok 동영상 하나의 캡션, 작성자, 게시 시각, 좋아요·댓글·공유·조회 수를 가져옵니다. 댓글과 트랜스크립트는 별도 액션으로 가져오며, 지표 이력은 보관되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수video,comments,transcript액션에 필요한 대상 TikTok 동영상 URL입니다.comments에서는 게시물 단위 댓글을 가져오며, 각 최상위 댓글에는 답글이 최대 2개까지 포함되고 전체 대화 트리를 보장하지 않습니다.
TikTok comments 파라미터는 각각 무엇을 의미하나요?
TikTok 동영상의 댓글을 읽어 옵니다. 좋아요 수, 답글 수, 답글 링크, 크리에이터의 좋아요 또는 고정 여부를 받을 수 있습니다. 최상위 댓글마다 답글은 최대 2개까지 포함되므로, 전체 대화 트리는 보장되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수video,comments,transcript액션에 필요한 대상 TikTok 동영상 URL입니다.comments에서는 게시물 단위 댓글을 가져오며, 각 최상위 댓글에는 답글이 최대 2개까지 포함되고 전체 대화 트리를 보장하지 않습니다.
TikTok hashtag 파라미터는 각각 무엇을 의미하나요?
해시태그로 게시된 TikTok 동영상을 탐색합니다. 각 동영상에는 캡션, 크리에이터, 좋아요·댓글·공유·조회 수가 포함됩니다. 태그는 # 포함 여부와 관계없이 전달할 수 있습니다. 일반 텍스트 검색이 아니며, 태그의 전체 규모나 추이를 측정하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태hashtag필수hashtag액션의 대상 해시태그 이름이며, 앞의#는 붙여도 되고 생략해도 됩니다. 해시태그로만 필터링하며 임의의 전문 검색어로 동작하지 않습니다.
TikTok followers 파라미터는 각각 무엇을 의미하나요?
핸들로 TikTok 계정의 팔로워·팔로잉·게시물·좋아요 총계를 확인하며, 반올림된 수치를 나타내는 정밀도 플래그가 함께 제공됩니다. 팔로워 이름이 아닌 수치만 반환합니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- 공개 TikTok 핸들이며, 앞의
@는 붙여도 되고 생략해도 됩니다. DouyinsecUid토큰이나 프로필 전체 URL은 입력하지 마세요.followers에서는 팔로워 수를 반환하고,shop_creator에서는 지정한 시장의 크리에이터 커머스 정보를 조회합니다.TikTok: 사용자 이름과 표시 닉네임의 차이 — TikTok은 사용자 이름과 닉네임을 구분합니다. 사용자 이름은 @ 핸들과 프로필 URL을 구성하고, 닉네임은 다른 사용자에게 보이는 표시 이름입니다. 사용자 이름을 바꾸면 프로필 URL도 바뀝니다. · 확인일 channel선택followers액션의 호환용 계정 핸들 입력입니다.username보다 우선순위가 낮습니다. TikTok Shop 상품 검색에는 사용되지 않습니다.
TikTok transcript 파라미터는 각각 무엇을 의미하나요?
URL로 TikTok 동영상의 트랜스크립트를 추출합니다. 전체 텍스트를 제공하며, 타임스탬프가 있는 경우 구간별 텍스트도 제공합니다. 먼저 has_transcript를 확인하세요. 동영상에 인식 가능한 음성이 있다는 보장은 없으며, 번역과 완벽한 정확도도 보장되지 않습니다.
url필수video,comments,transcript액션에 필요한 대상 TikTok 동영상 URL입니다.comments에서는 게시물 단위 댓글을 가져오며, 각 최상위 댓글에는 답글이 최대 2개까지 포함되고 전체 대화 트리를 보장하지 않습니다.
TikTok shop_search 파라미터는 각각 무엇을 의미하나요?
키워드로 TikTok Shop 상품을 찾습니다. 가격, 정가, 판매량, 평점, 리뷰 수, 카테고리, 상점 이름을 받을 수 있습니다. country로 시장을 지정하며 기본값은 US입니다. page를 사용해 결과 페이지를 차례로 조회합니다. 재고와 GMV는 계산하지 않습니다.
keyword필수search액션에서 공개 동영상을 검색할 검색어를 지정합니다.shop_search에서는 대신 별도의 데이터셋에 있는 TikTok Shop 상품을 검색합니다.country선택shop_search와shop_creator액션의 시장 지역 코드이며, 기본값은US또는us입니다. 크리에이터 국적이나 플랫폼 전체 콘텐츠 위치를 필터링하지 않습니다. 지원 시장은 카탈로그를 참고하세요.page선택shop_search상품 페이지네이션에 사용하는 1부터 시작하는 정수 페이지 번호이며, 기본값은1입니다. 동영상 댓글이나 작성자 동영상 목록의 페이지네이션에는 사용되지 않습니다.
TikTok shop_creator 파라미터는 각각 무엇을 의미하나요?
핸들로 TikTok Shop 크리에이터의 규모를 파악합니다. 카테고리, 팔로워 수, 동영상 수, 홍보 상품, 판매량, 평균 조회수를 받을 수 있습니다. country는 크리에이터의 국적이 아니라 Shop 시장을 지정합니다. 비공개 매출, 수수료, 구매자는 표시되지 않습니다.
username필수- 공개 TikTok 핸들이며, 앞의
@는 붙여도 되고 생략해도 됩니다. DouyinsecUid토큰이나 프로필 전체 URL은 입력하지 마세요.followers에서는 팔로워 수를 반환하고,shop_creator에서는 지정한 시장의 크리에이터 커머스 정보를 조회합니다. country선택shop_search와shop_creator액션의 시장 지역 코드이며, 기본값은US또는us입니다. 크리에이터 국적이나 플랫폼 전체 콘텐츠 위치를 필터링하지 않습니다. 지원 시장은 카탈로그를 참고하세요.
TikTok hashtag_search 파라미터는 각각 무엇을 의미하나요?
keyword로 TikTok 해시태그를 검색합니다. 각 해시태그에는 ID, 이름, 링크, 설명, 동영상 수, 조회수가 포함됩니다. 페이지당 20개이며, next_page_token으로 다음 페이지를 가져옵니다. 해시태그 아래의 동영상이 아니라 해시태그를 찾으며, 동영상은 hashtag에 이름을 전달해 가져옵니다.
keyword필수- TikTok 해시태그 이름에서 검색할 단어입니다(예: fitness). 앞에 붙은 #는 제거됩니다.
page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok music_search 파라미터는 각각 무엇을 의미하나요?
곡이나 아티스트 같은 keyword로 TikTok 사운드 라이브러리를 검색합니다. 각 사운드에는 ID, 제목, 아티스트, 앨범, 길이, 사용한 동영상 수, 오리지널 사운드 및 상업용 라이브러리 플래그, 발매일, 커버, 짧은 미리듣기 링크가 포함됩니다. 페이지당 20개이며, next_page_token으로 다음 페이지를 가져옵니다.
keyword필수- 검색할 곡 제목, 아티스트 또는 사운드 이름입니다(예: taylor swift).
page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok music_chart 파라미터는 각각 무엇을 의미하나요?
TikTok 음악 차트 top50(기본값) 또는 viral50을 읽어 옵니다. 각 사운드에는 rank, ID, 제목, 아티스트, 앨범, 언어, 길이, 사용 횟수, 상업용 라이브러리 플래그, 발매일, 커버, 미리듣기 링크가 포함됩니다. 한 번 호출하면 차트 50곡 전체가 반환됩니다.
chart선택music_chart가 읽을 음악 차트로,top50(기본값) 또는viral50입니다.허용 값:top50viral50
TikTok user_search 파라미터는 각각 무엇을 의미하나요?
keyword로 TikTok 계정을 TikTok 검색 순위대로 검색합니다. 각 계정에는 사용자 ID, 핸들, 표시 이름, sec_uid, 팔로워·팔로잉·좋아요·동영상 수, 인증 여부, 아바타, 현재 라이브 여부가 포함됩니다. 페이지당 20개이며, next_page_token으로 다음 페이지를 가져옵니다.
keyword필수- TikTok 계정을 검색할 단어입니다(예: cooking). TikTok 검색처럼 핸들, 이름, 소개글에서 일치 항목을 찾습니다.
page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok sound_videos 파라미터는 각각 무엇을 의미하나요?
music_id나 사운드 페이지 링크로 특정 사운드를 사용한 TikTok 동영상을 나열합니다. 각 동영상에는 캡션, 작성자, 게시 시각, 재생·좋아요·댓글·공유·저장 수, 길이, 해시태그, 광고·고정·슬라이드쇼 플래그가 포함됩니다. 페이지당 약 20개이며, next_page_token으로 다음 페이지를 가져옵니다.
music_id필수sound_videos에 사용할 숫자 TikTok 사운드 ID(music_search또는music_chart행의id) 또는 https://www.tiktok.com/music/<name>-<ID> 같은 사운드 페이지 링크입니다.page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok comment_replies 파라미터는 각각 무엇을 의미하나요?
동영상 url과 comments가 반환한 댓글 id로 TikTok 동영상의 댓글 하나에 달린 답글을 읽어 옵니다. 각 답글에는 본문, 좋아요 수, 시각, 답글 작성자의 핸들·이름·ID, 크리에이터의 좋아요 여부가 포함됩니다. 페이지당 최대 20개이며, next_page_token으로 다음 페이지를 가져옵니다.
url필수- 댓글이 달린 TikTok 동영상: https://www.tiktok.com/@<user>/video/<ID> 또는 동영상 ID입니다.
comment_id필수comment_replies가 답글을 읽을 최상위 댓글의 숫자 ID로,comments행의id입니다.page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok shop_hot_products 파라미터는 각각 무엇을 의미하나요?
동남아시아 또는 아시아 시장 한 곳의 TikTok Shop 베스트셀러 목록을 읽어 옵니다. 지원 시장은 ID, JP, MX, MY(기본값), PH, SG, TH, VN입니다. 각 상품에는 rank, ID, 링크, 이름, 가격, 정가, 통화, 판매량, 평점, 리뷰 수, 상점 이름, shop_id가 포함됩니다. 미국, 영국, 브라질은 베스트셀러 목록이 없습니다.
country선택- TikTok Shop 마켓: ID, JP, MX, MY(기본값), PH, SG, TH 또는 VN입니다. 미국, 영국, 브라질은 베스트셀러 목록이 없어 과금 전에 거부됩니다.
TikTok shop_category_products 파라미터는 각각 무엇을 의미하나요?
선택한 시장에서 category_id(예: 뷰티·퍼스널 케어는 601450)로 TikTok Shop 카테고리 하나에 속한 상품을 나열합니다. 각 상품에는 ID, 링크, 이름, 가격, 정가, 통화, 판매량, 평점, 리뷰 수, 상점 이름, shop_id가 포함됩니다. 페이지당 약 15개이며, next_page_token으로 다음 페이지를 가져옵니다.
category_id필수shop_category_products에 사용할 숫자 TikTok Shop 카테고리 ID입니다(예: 601450, 뷰티 및 퍼스널 케어). 1차, 2차, 3차 카테고리 모두 사용할 수 있습니다.country선택- TikTok Shop 마켓: US(기본값), SG, MY, PH, TH, VN, ID, JP 또는 MX입니다.
page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok following 파라미터는 각각 무엇을 의미하나요?
핸들로 TikTok 사용자가 팔로우하는 계정을 나열합니다. 각 계정에는 사용자 ID, 핸들, 표시 이름, sec_uid, 소개, 팔로워·팔로잉·좋아요·동영상 수, 인증 여부, 아바타, 국가가 포함됩니다. 페이지당 20개이며, next_page_token으로 다음 페이지를 가져옵니다. 사용자가 팔로잉 목록을 숨긴 경우 빈 목록이 반환됩니다.
username필수- 팔로잉 계정을 조회할 TikTok 핸들입니다(예: zachking). 앞에 붙은 @는 제거됩니다.
sec_uid도 사용할 수 있습니다. page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok video_download 파라미터는 각각 무엇을 의미하나요?
url로 TikTok 동영상 하나의 워터마크 없는 다운로드 링크를 가져옵니다. 백업 링크가 포함된 video_url, 크기, 너비와 높이, 있는 경우 고화질 링크, 워터마크 포함 링크, 사운드, 커버, 링크가 만료되는 시각인 expires_at을 받을 수 있습니다. 사진 게시물은 대신 image_urls를 반환합니다.
url필수- TikTok 동영상 링크 1개: https://www.tiktok.com/@<user>/video/<ID> 또는 /photo/ 링크, 혹은 동영상 ID입니다. vt.tiktok.com 단축 링크는 받지 않습니다.
TikTok live_room 파라미터는 각각 무엇을 의미하나요?
핸들로 TikTok 계정이 지금 라이브 중인지 확인합니다. 라이브 중이면 방 ID, 제목, 링크, 현재·최고·누적 시청자 수, 좋아요 수, 공유 수, 상품 수, 시작 시각, 커버, 만료되는 스트림 링크를 받을 수 있습니다. 라이브 중이 아닌 계정은 is_live가 false인 행 하나를 반환합니다.
username필수- 확인할 TikTok 핸들입니다(예: tiktoklive_latam). 앞에 붙은 @는 제거되며, 프로필 링크도 사용할 수 있습니다.
TikTok shop_products 파라미터는 각각 무엇을 의미하나요?
선택한 시장에서 shop_id나 상점 링크로 TikTok Shop 내 한 상점의 상품을 나열합니다. 각 상품에는 ID, 링크, 이름, 가격, 정가, 통화, 판매량, 평점, 리뷰 수, 상점 이름, shop_id가 포함됩니다. 페이지당 최대 30개이며, next_page_token으로 다음 페이지를 가져옵니다.
shop_id필수shop_products에 사용할 숫자 TikTok Shop 상점 ID로, 상품 행의shop_id또는 ID로 끝나는 shop.tiktok.com 상점 링크입니다.country선택- 스토어가 판매하는 TikTok Shop 마켓: US(기본값), SG, MY, PH, TH, VN, ID, JP 또는 MX입니다.
page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
TikTok shop_product_reviews 파라미터는 각각 무엇을 의미하나요?
product_id나 상품 링크로 TikTok Shop 상품 하나의 구매자 리뷰를 읽어 옵니다. 각 리뷰에는 별점 rating, 본문, 게시 시각, 구매한 옵션, 구매 인증 및 인센티브 제공 플래그, 사진, 마스킹된 구매자 이름, 국가가 포함됩니다. 최신순 또는 추천순으로 정렬하고 rating으로 특정 별점만 남길 수 있습니다. 페이지당 20개입니다.
product_id필수shop_product_reviews에 사용할 숫자 TikTok Shop 상품 ID(상품 행의id) 또는 shop.tiktok.com 상품 링크입니다.country선택- 상품이 판매되는 TikTok Shop 마켓: US(기본값), SG, MY, PH, TH, VN, ID, JP 또는 MX입니다.
page_token선택hashtag_search,user_search,following,shop_products등 TikTok 목록 액션의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.rating선택shop_product_reviews에서 지정한 별점(1~5)의 리뷰만 남깁니다. 모든 리뷰를 받으려면 생략하세요.허용 값:12345sort선택- 리뷰 정렬:
newest(기본값) 또는recommended(TikTok Shop 자체 순서)입니다.허용 값:newestrecommended
TikTok trending_hashtags 파라미터는 각각 무엇을 의미하나요?
시장 한 곳에서 최근 7일, 30일 또는 90일간의 TikTok 인기 급상승 해시태그를 읽어 오며, 필요하면 업종 하나로 좁힐 수 있습니다. 각 해시태그에는 rank, ID, 이름, 링크, 동영상 수, 조회수, 그리고 0~100 범위의 일별 인기도인 trend가 포함됩니다. 페이지당 20개, 총 100개이며, next_page_token으로 다음 페이지를 가져옵니다.
TikTok API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"tiktok","action":"search","params":{"keyword":"<keyword>"}}'
TikTok 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
TikTok 크리에이터 데이터 API: 프로필과 동영상 샘플로 1차 선별하기
TikTok profile 및 user_videos 엔드포인트를 연동하고, 계정 스냅샷과 동영상 스냅샷을 분리하고, 명확한 참여 지표를 계산하고, 누락 값을 처리하며, 공개 데이터를 전환 성과로 취급하지 않는 방법을 다룹니다.
글 읽기캠페인 전 실사를 위한 크리에이터 데이터 구성법: 팔로워 수를 오디언스의 증거로 삼지 않기
크리에이터 데이터 제품은 블랙박스식 진정성 점수를 만들어 내지 않아야 합니다. 이 글에서는 공개 지표, 승인된 분석 데이터, 콘텐츠와 브랜드의 적합성, 광고 표기 요건, 소규모 테스트, 캠페인 후 피드백이 어떻게 검증 가능한 실사를 구성하는지 살펴봅니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기TikTok API 자주 묻는 질문
TikTok API로 무엇을 가져올 수 있나요?
platform을 tiktok 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 프로필, 사용자 동영상, 동영상 상세 정보, 댓글 및 more입니다. 각 액션 이름은 서로 다른 TikTok 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
TikTok에 공식 API가 있나요?
TikTok은 TikTok for Developers를 통해 공식 API를 제공하지만, Display API와 Content Posting API는 계정 소유자가 앱에 권한을 부여한 경우에만 해당 계정에서 작동합니다. 공개 동영상과 댓글에 대한 폭넓은 접근은 Research API로 제공되며, 대상 지역의 승인된 비영리 학술·연구 기관만 이용할 수 있습니다.
공식 출처: TikTok for Developers: Research API · TikTok for Developers: scopes overview · 확인일
TikTok 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. TikTok 개발자 앱을 등록하거나, TikTok API 접근을 신청하거나, TikTok 계정으로 로그인할 필요가 없으며, 액션은 공개된 TikTok 데이터만 반환합니다.
TikTok API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $0.56부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
TikTok search 요청에는 어떤 입력이 필요한가요?
search 액션에서 공개 동영상을 검색할 검색어를 지정합니다. shop_search에서는 대신 별도의 데이터셋에 있는 TikTok Shop 상품을 검색합니다. params 안의 keyword 필드로 전달하세요.
TikTok search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 text, author_name, author_username 및 like_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 TikTok 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.