플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Toutiao 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
글 상세 정보article | URL로 Toutiao 기사나 동영상을 읽어 옵니다. | 요청 1,000개당 $0.56 | 정상 |
프로필profile | Toutiao 계정의 닉네임, 소개, 아바타, 프로필 링크, 인증 상태와 인증 설명을 가져옵니다. | 요청 1,000개당 $0.56 | 정상 |
사용자 게시물user_posts | Toutiao 작성자의 기사, 동영상, 짧은 게시물을 나열합니다. | 요청 1,000개당 $0.56 | 정상 |
프로필 검색profile_search | 키워드로 Toutiao 계정 하나의 게시물 안에서 검색합니다. | 요청 1,000개당 $0.56 | 정상 |
댓글comments | Toutiao 기사나 동영상의 최상위 댓글을 페이지당 20개씩 읽어 옵니다. | 요청 1,000개당 $0.81 | 정상 |
동영상 상세 정보video | 링크나 숫자 ID로 Toutiao 동영상 하나를 조회합니다. | 요청 1,000개당 $0.81 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Toutiao 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
article글 상세 정보 URL로 Toutiao 기사나 동영상을 읽어 옵니다. 제목, 본문, 커버, 읽음 또는 재생 수, 좋아요 수, 댓글 수, 공유 수, 작성자 인증 정보를 받을 수 있습니다. 전문이나 트랜스크립트는 페이지에 표시되는 경우에만 제공됩니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.56 | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
profile프로필 Toutiao 계정의 닉네임, 소개, 아바타, 프로필 링크, 인증 상태와 인증 설명을 가져옵니다. | user_id | — | Sync 응답 | — | 요청 1,000개당 $0.56 | user_id · nickname · bio · url · avatar_url · is_verified · verify_reason · platform |
user_posts사용자 게시물 Toutiao 작성자의 기사, 동영상, 짧은 게시물을 나열합니다. 제목, 본문, 읽음 또는 재생 수, 좋아요 수, 댓글 수, 공유 수, 게시 시각을 받을 수 있습니다. | user_id | tab | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
profile_search프로필 검색 키워드로 Toutiao 계정 하나의 게시물 안에서 검색합니다. 일치하는 기사와 동영상을 본문, 읽음 또는 재생 수, 반응 수와 함께 받을 수 있습니다. | user_id, keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
comments댓글 Toutiao 기사나 동영상의 최상위 댓글을 페이지당 20개씩 읽어 옵니다. 각 댓글에는 본문, 좋아요 수, 답글 수, 시각, 댓글 작성자의 이름·아바타·인증 정보·IP 지역, 원글 작성자의 좋아요 여부가 포함됩니다. 기사나 동영상 링크 또는 숫자 ID를 전달하고, | url | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | id · text · like_count · reply_count · posted_at · author_id · author_name · author_avatar_url · author_verified · author_auth_info · ip_location · liked_by_author · platform |
video동영상 상세 정보 링크나 숫자 ID로 Toutiao 동영상 하나를 조회합니다. 제목, 길이, 재생 수, 좋아요 수, 댓글 수, 공유 수, 저장 수, 게시 시각, 커버, 서명된 동영상 파일 링크, 작성자 이름을 받을 수 있으며, 가로 동영상은 노출 수, 작성자 프로필 토큰, 팔로워 수가 추가됩니다. 세로형 짧은 동영상도 지원합니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.81 | id · url · video_type · title · duration_sec · duration_seconds · play_count · like_count · comment_count · share_count · collect_count · impression_count · posted_at · cover_url · video_url · author_id · author_name · author_avatar_url · author_follower_count · author_verified · author_auth_info · platform |
Toutiao article 파라미터는 각각 무엇을 의미하나요?
URL로 Toutiao 기사나 동영상을 읽어 옵니다. 제목, 본문, 커버, 읽음 또는 재생 수, 좋아요 수, 댓글 수, 공유 수, 작성자 인증 정보를 받을 수 있습니다. 전문이나 트랜스크립트는 페이지에 표시되는 경우에만 제공됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수article액션에 사용할 특정 기사 또는 동영상의 전체 URL입니다. 사용자 단위 액션에서url과user_id를 모두 전달하면 프로필 페이지 식별에url이 우선합니다.
Toutiao profile 파라미터는 각각 무엇을 의미하나요?
Toutiao 계정의 닉네임, 소개, 아바타, 프로필 링크, 인증 상태와 인증 설명을 가져옵니다. user_id에는 닉네임이나 짧은 숫자 ID가 아니라, 보통 MS4w로 시작하는 계정 토큰이나 전체 프로필 URL을 전달합니다.
user_id필수- 대상 사용자 프로필 토큰 또는
secUid로, 보통MS4w로 시작합니다. 이 필드에 Toutiao 프로필 전체 URL을 전달해도 됩니다. 표시 닉네임이나 짧은 숫자 UID는 받지 않습니다.
Toutiao user_posts 파라미터는 각각 무엇을 의미하나요?
Toutiao 작성자의 기사, 동영상, 짧은 게시물을 나열합니다. 제목, 본문, 읽음 또는 재생 수, 좋아요 수, 댓글 수, 공유 수, 게시 시각을 받을 수 있습니다. tab으로 프로필 섹션을 선택합니다. 한 번에 아카이브 전체를 가져오지 못할 수 있습니다.
user_id필수- 대상 사용자 프로필 토큰 또는
secUid로, 보통MS4w로 시작합니다. 이 필드에 Toutiao 프로필 전체 URL을 전달해도 됩니다. 표시 닉네임이나 짧은 숫자 UID는 받지 않습니다. tab선택user_posts에서 프로필 피드 탭을 선택합니다. 허용 값은all(기본값),article,video,ugc,short_video입니다. 항목 상세 유형은 바꾸지 않습니다.Toutiao: Micro-Toutiao와 아티클은 별개의 콘텐츠 유형 — Toutiao 크리에이터 고객센터는 Micro-Toutiao를 짧은 소셜 콘텐츠로 설명하며, 게시와 편집 절차를 따로 안내합니다. 이 API는 위의 컬럼 사양에 따라 게시물을 읽을 뿐이며, 이러한 절차를 참조한다고 해서 게시, 편집, 토픽 참여, 크리에이터 수익 창출 기능을 갖게 되지는 않습니다. · 확인일
Toutiao profile_search 파라미터는 각각 무엇을 의미하나요?
키워드로 Toutiao 계정 하나의 게시물 안에서 검색합니다. 일치하는 기사와 동영상을 본문, 읽음 또는 재생 수, 반응 수와 함께 받을 수 있습니다. user_id와 keyword는 모두 필수입니다. 사람을 찾거나 플랫폼 전체를 검색하지는 않습니다.
user_id필수- 대상 사용자 프로필 토큰 또는
secUid로, 보통MS4w로 시작합니다. 이 필드에 Toutiao 프로필 전체 URL을 전달해도 됩니다. 표시 닉네임이나 짧은 숫자 UID는 받지 않습니다. keyword필수profile_search에서user_id로 지정한 대상 프로필 안의 게시물만 검색할 검색어입니다. Toutiao 플랫폼 전체를 검색하지 않습니다.
Toutiao comments 파라미터는 각각 무엇을 의미하나요?
Toutiao 기사나 동영상의 최상위 댓글을 페이지당 20개씩 읽어 옵니다. 각 댓글에는 본문, 좋아요 수, 답글 수, 시각, 댓글 작성자의 이름·아바타·인증 정보·IP 지역, 원글 작성자의 좋아요 여부가 포함됩니다. 기사나 동영상 링크 또는 숫자 ID를 전달하고, next_page_token으로 페이지를 넘기세요. 답글 자체는 반환되지 않으며, reply_count로 답글 수를 알 수 있습니다.
url필수- Toutiao 기사 또는 동영상 링크(https://www.toutiao.com/article/<ID>/ 또는 https://www.toutiao.com/video/<ID>/, 예전 형식인 /i<ID>/, /a<ID>/, /item/<ID>/ 링크도 사용 가능) 또는 링크 안의 숫자 ID입니다. 호출마다 최상위 댓글을 최대 20개까지 1페이지로 반환합니다.
page_token선택comments의 페이지 토큰입니다. 다음 페이지를 받으려면 이전 응답의next_page_token을 전달하고, 첫 페이지부터 시작하려면 생략하세요.url은 토큰을 반환한 호출과 같게 유지하세요. 토큰은 24시간 동안 유효하며 페이지마다 호출 1회로 계산됩니다.
Toutiao video 파라미터는 각각 무엇을 의미하나요?
링크나 숫자 ID로 Toutiao 동영상 하나를 조회합니다. 제목, 길이, 재생 수, 좋아요 수, 댓글 수, 공유 수, 저장 수, 게시 시각, 커버, 서명된 동영상 파일 링크, 작성자 이름을 받을 수 있으며, 가로 동영상은 노출 수, 작성자 프로필 토큰, 팔로워 수가 추가됩니다. 세로형 짧은 동영상도 지원합니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- Toutiao 동영상 링크(https://www.toutiao.com/video/<ID>/, /item/<ID>/ 및 /group/<ID>/ 링크도 사용 가능) 또는 링크 안의 숫자 ID입니다. 기사 ID를 넣으면 빈 결과가 반환됩니다.
Toutiao 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":"toutiao","action":"article","params":{"url":"<url>"}}'
Toutiao API 자주 묻는 질문
Toutiao API로 무엇을 가져올 수 있나요?
platform을 toutiao 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 글 상세 정보, 프로필, 사용자 게시물, 프로필 검색, 댓글 및 more입니다. 각 액션 이름은 서로 다른 Toutiao 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Toutiao article 요청에는 어떤 입력이 필요한가요?
article 액션에 사용할 특정 기사 또는 동영상의 전체 URL입니다. 사용자 단위 액션에서 url과 user_id를 모두 전달하면 프로필 페이지 식별에 url이 우선합니다. params 안의 url 필드로 전달하세요.
Toutiao article 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 type, title, text 및 content_text입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Toutiao 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.