플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Odysee 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword로 Odysee 동영상을 검색하며, 각 결과의 제목, 채널, 재생 시간, 조회수와 좋아요 수, 언어, 태그를 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
인기 급상승trending | 입력 없이 Odysee에서 인기 급상승 중인 콘텐츠를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
사용자 게시물user_posts | 이름, @이름 또는 채널 링크로 Odysee 채널의 업로드를 탐색합니다. | 요청 1,000개당 $32 | 정상 |
태그tag | 태그가 붙은 Odysee 업로드를 최신순 또는 인기순으로 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Odysee 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform |
trending인기 급상승 입력 없이 Odysee에서 인기 급상승 중인 콘텐츠를 확인합니다. 각 항목에는 제목, 채널, 재생 시간, 조회수, 좋아요 수, 게시 시각이 포함됩니다. 순위를 알 수 있는 정보는 순서뿐입니다. 인기 급상승 알고리즘은 공개되지 않으며, 호출 간 이력은 보관되지 않습니다. | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform | |
user_posts사용자 게시물 이름, @이름 또는 채널 링크로 Odysee 채널의 업로드를 탐색합니다. 최신순 또는 후원 기반 인기순으로 정렬하며 조회수, 좋아요 수, 재생 시간, 태그를 제공합니다. 콜론 뒤의 내용(클레임 ID)은 제거되므로, 이름이 겹치는 경우 채널을 확인하세요. | username | sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $32 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform |
tag태그 태그가 붙은 Odysee 업로드를 최신순 또는 인기순으로 찾습니다. 태그는 # 포함 여부와 관계없이 입력할 수 있습니다. 채널, 조회수, 좋아요 수, 재생 시간을 받을 수 있습니다. | tag | sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform |
Odysee search 파라미터는 각각 무엇을 의미하나요?
keyword로 Odysee 동영상을 검색하며, 각 결과의 제목, 채널, 재생 시간, 조회수와 좋아요 수, 언어, 태그를 제공합니다. 동영상을 재생하거나 다운로드하지 않으며, 결과가 플랫폼 전체를 포괄하는 색인은 아닙니다.
keyword필수- search 액션의 동영상 검색어를 지정합니다. trending 액션은 keyword 파라미터를 받지 않습니다. search는 채널 목록에 쓰이는 sort 옵션을 받지 않습니다.Odysee: 표시 제목과 콘텐츠 URL은 별개다 — Odysee는 업로드된 콘텐츠의 Title, URL, Description이 각각 다른 용도를 가진다고 명시적으로 구분합니다. 검색 결과는 제목으로 주소를 만들어내지 말고 원래 링크와 제목을 그대로 유지해야 하며, 설명 텍스트는 동영상 전체 스크립트가 아닙니다. · 확인일
Odysee trending 파라미터는 각각 무엇을 의미하나요?
입력 없이 Odysee에서 인기 급상승 중인 콘텐츠를 확인합니다. 각 항목에는 제목, 채널, 재생 시간, 조회수, 좋아요 수, 게시 시각이 포함됩니다. 순위를 알 수 있는 정보는 순서뿐입니다. 인기 급상승 알고리즘은 공개되지 않으며, 호출 간 이력은 보관되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태이 액션에는 비즈니스 파라미터가 없습니다. 플랫폼과 액션 식별자만 보내면 됩니다.
Odysee user_posts 파라미터는 각각 무엇을 의미하나요?
이름, @이름 또는 채널 링크로 Odysee 채널의 업로드를 탐색합니다. 최신순 또는 후원 기반 인기순으로 정렬하며 조회수, 좋아요 수, 재생 시간, 태그를 제공합니다. 콜론 뒤의 내용(클레임 ID)은 제거되므로, 이름이 겹치는 경우 채널을 확인하세요.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- user_posts 액션의 채널 식별자를 지정합니다. 채널 이름, @name 또는 Odysee 채널 전체 URL을 받습니다. 콜론 뒤의 내용(claim ID)은 제거되므로 채널 이름이 겹치는 경우 결과를 확인해야 합니다.Odysee: 채널 이름과 Claim 식별자는 다르다 — Odysee 이름 지정 문서에 따르면 URL에서 콜론 뒤 부분은 특정 채널이나 콘텐츠의 Claim과 관련되며, 이름이 같은 주소를 구분하려면 전체 식별자가 필요합니다. 이 인터페이스는 채널 이름을 추출할 때 해당 부분을 제거합니다. 이 문서를 인용한다고 해서 정확한 Claim 조회를 지원한다는 의미는 아닙니다. · 확인일
sort선택- user_posts와 tag 액션의 콘텐츠를 정렬합니다. 허용 값은 newest(게시일순)와 popular(후원 금액 지표순)입니다. popular는 총 조회수나 좋아요 수를 기준으로 하지 않습니다.허용 값:
newestpopular
Odysee tag 파라미터는 각각 무엇을 의미하나요?
태그가 붙은 Odysee 업로드를 최신순 또는 인기순으로 찾습니다. 태그는 # 포함 여부와 관계없이 입력할 수 있습니다. 채널, 조회수, 좋아요 수, 재생 시간을 받을 수 있습니다. popular는 조회수나 좋아요가 아니라 후원 금액을 기준으로 합니다. 태그가 콘텐츠의 실제 내용을 보증하지는 않습니다.
tag필수- tag 액션의 콘텐츠 태그를 지정하며, 앞의 해시 기호(#)는 붙여도 되고 생략해도 됩니다. 구조화된 태그와 일치하는 항목을 필터링하며 일반적인 전문 키워드 검색은 수행하지 않습니다.Odysee: 콘텐츠 태그, 제어 태그, 언어 설정 — Odysee는 주제 태그와 상호작용 제어 태그를 구분하고, 콘텐츠 언어와 저작권 라이선스를 별도 설정으로 제공합니다. 이 인터페이스가 반환하는 태그와 언어는 실제로 조회한 정보만 나타내며, 업로드, 상호작용 제어, 번역, 콘텐츠 신디케이션 권한을 부여하지 않습니다. · 확인일
sort선택- user_posts와 tag 액션의 콘텐츠를 정렬합니다. 허용 값은 newest(게시일순)와 popular(후원 금액 지표순)입니다. popular는 총 조회수나 좋아요 수를 기준으로 하지 않습니다.허용 값:
newestpopular
Odysee 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":"odysee","action":"search","params":{"keyword":"<keyword>"}}'
Odysee API 자주 묻는 질문
Odysee API로 무엇을 가져올 수 있나요?
platform을 odysee 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 인기 급상승, 사용자 게시물 및 태그입니다. 각 액션 이름은 서로 다른 Odysee 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Odysee search 요청에는 어떤 입력이 필요한가요?
search 액션의 동영상 검색어를 지정합니다. trending 액션은 keyword 파라미터를 받지 않습니다. search는 채널 목록에 쓰이는 sort 옵션을 받지 않습니다. params 안의 keyword 필드로 전달하세요.
Odysee search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, description, channel_name 및 channel_id입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Odysee 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.