플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Lemmy 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword로 인스턴스 하나의 Lemmy 게시물을 검색하며, 커뮤니티, 작성자, 점수, 추천 및 비추천 수, 댓글 수, 외부 링크, NSFW·잠금·고정 플래그를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
커뮤니티community | 이름 또는 name@instance로 Lemmy 커뮤니티의 게시물을 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
뉴스 피드feed | Lemmy 인스턴스(기본값 lemmy.world)의 게시물 피드를 탐색합니다. | 요청 1,000개당 $1.39 | 정상 |
댓글comments | Lemmy 커뮤니티 게시물의 댓글을 가져오며, 점수, 투표 수, 깊이, 상위 댓글 ID, 삭제 플래그, 소속 게시물이 포함됩니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Lemmy 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | instance, sort, top_range | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform |
community커뮤니티 이름 또는 name@instance로 Lemmy 커뮤니티의 게시물을 조회합니다. 점수, 투표 수, 댓글 수, 링크, 게시물 플래그를 가져오며 기본적으로 인기순으로 정렬됩니다. 다른 인스턴스에 있는 같은 이름의 커뮤니티는 합쳐지지 않습니다. | community | instance, sort, top_range | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform |
feed뉴스 피드 Lemmy 인스턴스(기본값 lemmy.world)의 게시물 피드를 탐색합니다. 게시물별 커뮤니티, 점수, 투표 수, 댓글 수, 플래그가 포함되며 기본 정렬은 활동순입니다. 개인화된 타임라인이 아니며 페디버스 전체를 보여 주지도 않습니다. | instance, sort, top_range | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform | |
comments댓글 Lemmy 커뮤니티 게시물의 댓글을 가져오며, 점수, 투표 수, 깊이, 상위 댓글 ID, 삭제 플래그, 소속 게시물이 포함됩니다. | community | instance, max_comments, sort, top_range | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · text · author_username · author_url · score · upvote_count · downvote_count · depth · parent_comment_id · is_deleted · post_url · post_title · community · posted_at · platform |
Lemmy search 파라미터는 각각 무엇을 의미하나요?
keyword로 인스턴스 하나의 Lemmy 게시물을 검색하며, 커뮤니티, 작성자, 점수, 추천 및 비추천 수, 댓글 수, 외부 링크, NSFW·잠금·고정 플래그를 가져옵니다. 검색은 선택한 instance(기본값 lemmy.world)에서 실행되며 페디버스 전체를 다루지 않습니다.
keyword필수- Lemmy search 액션의 검색어를 지정합니다. 검색은 지정한 인스턴스에서 실행되며, 연합된 모든 인스턴스를 빠짐없이 검색한다고 보장하지 않습니다.Lemmy: 인스턴스에서 보이는 범위가 Fediverse 전체는 아니다 — 공식 온보딩 가이드는 인스턴스마다 운영자가 다르며, 일반 탐색에서는 로컬 인스턴스가 알고 있는 커뮤니티만 표시되고 다른 인스턴스의 객체는 별도로 조회해야 한다고 설명합니다. 이는 인스턴스 관점과 게시물 객체를 설명하기 위한 맥락이며, 웹 검색 기능 전체를 게이트웨이 파라미터로 그대로 옮기지는 않습니다. · 확인일
instance선택- lemmy.world 같은 Lemmy 인스턴스 도메인을 선택하며, 기본값도 lemmy.world입니다. 인스턴스 전체 URL도 받지만 호스트 이름만 사용합니다. 커뮤니티 이름이 아니라 조회 진입점을 선택합니다.
sort선택- 게시물을 hot, active, new, top, most_comments, new_comments 중 하나로 정렬합니다. 기본값은 search와 community에서 hot, feed에서 active, comments에서 most_comments입니다.허용 값:
activehotmost_commentsnewnew_commentstop top_range선택- sort가 top일 때만 점수 집계 기간을 설정합니다: hour, sixhour, twelvehour, day, week(기본값), month, threemonths, sixmonths, ninemonths, year, all. 댓글 게시일 필터가 아닙니다.허용 값:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Lemmy community 파라미터는 각각 무엇을 의미하나요?
이름 또는 name@instance로 Lemmy 커뮤니티의 게시물을 조회합니다. 점수, 투표 수, 댓글 수, 링크, 게시물 플래그를 가져오며 기본적으로 인기순으로 정렬됩니다. 다른 인스턴스에 있는 같은 이름의 커뮤니티는 합쳐지지 않습니다. top_range는 top으로 정렬할 때만 적용됩니다.
community필수- 커뮤니티 이름 또는 name@instance 형식의 인스턴스 간 식별자를 지정합니다. community 액션에서는 커뮤니티 게시물을 나열하고, comments 액션에서는 단일 게시물 URL을 직접 조회하는 대신 커뮤니티의 게시물을 가져와 댓글을 펼칩니다.Lemmy: 커뮤니티 식별자와 인스턴스 간 접근 — 공식 가이드는 커뮤니티 URL과 !name@instance 식별자 형식을 소개하고 로컬 커뮤니티와 연합 커뮤니티를 구분합니다. EveryInfra에서는 이 파라미터를 name 또는 name@instance 형식으로 지정하며, 공식 UI의 ! 접두사와 URL 형식은 이 인터페이스에서 자동으로 지원되지 않습니다. · 확인일
instance선택- lemmy.world 같은 Lemmy 인스턴스 도메인을 선택하며, 기본값도 lemmy.world입니다. 인스턴스 전체 URL도 받지만 호스트 이름만 사용합니다. 커뮤니티 이름이 아니라 조회 진입점을 선택합니다.
sort선택- 게시물을 hot, active, new, top, most_comments, new_comments 중 하나로 정렬합니다. 기본값은 search와 community에서 hot, feed에서 active, comments에서 most_comments입니다.허용 값:
activehotmost_commentsnewnew_commentstop top_range선택- sort가 top일 때만 점수 집계 기간을 설정합니다: hour, sixhour, twelvehour, day, week(기본값), month, threemonths, sixmonths, ninemonths, year, all. 댓글 게시일 필터가 아닙니다.허용 값:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Lemmy feed 파라미터는 각각 무엇을 의미하나요?
Lemmy 인스턴스(기본값 lemmy.world)의 게시물 피드를 탐색합니다. 게시물별 커뮤니티, 점수, 투표 수, 댓글 수, 플래그가 포함되며 기본 정렬은 활동순입니다. 개인화된 타임라인이 아니며 페디버스 전체를 보여 주지도 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태instance선택- lemmy.world 같은 Lemmy 인스턴스 도메인을 선택하며, 기본값도 lemmy.world입니다. 인스턴스 전체 URL도 받지만 호스트 이름만 사용합니다. 커뮤니티 이름이 아니라 조회 진입점을 선택합니다.
sort선택- 게시물을 hot, active, new, top, most_comments, new_comments 중 하나로 정렬합니다. 기본값은 search와 community에서 hot, feed에서 active, comments에서 most_comments입니다.허용 값:
activehotmost_commentsnewnew_commentstop top_range선택- sort가 top일 때만 점수 집계 기간을 설정합니다: hour, sixhour, twelvehour, day, week(기본값), month, threemonths, sixmonths, ninemonths, year, all. 댓글 게시일 필터가 아닙니다.허용 값:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Lemmy comments 파라미터는 각각 무엇을 의미하나요?
Lemmy 커뮤니티 게시물의 댓글을 가져오며, 점수, 투표 수, 깊이, 상위 댓글 ID, 삭제 플래그, 소속 게시물이 포함됩니다. max_comments는 요청 전체가 아닌 게시물당 댓글 수의 상한으로, 1~200 범위이며 기본값은 50입니다.
community필수- 커뮤니티 이름 또는 name@instance 형식의 인스턴스 간 식별자를 지정합니다. community 액션에서는 커뮤니티 게시물을 나열하고, comments 액션에서는 단일 게시물 URL을 직접 조회하는 대신 커뮤니티의 게시물을 가져와 댓글을 펼칩니다.
instance선택- lemmy.world 같은 Lemmy 인스턴스 도메인을 선택하며, 기본값도 lemmy.world입니다. 인스턴스 전체 URL도 받지만 호스트 이름만 사용합니다. 커뮤니티 이름이 아니라 조회 진입점을 선택합니다.
max_comments선택- comments 액션에서 게시물당 가져올 최대 댓글 수를 설정하며, 기본값은 50이고 허용 범위는 1~200입니다. 요청 전체의 게시물 수나 댓글 수가 아닌 게시물당 댓글 수를 제한하며, 허용 범위를 벗어난 값은 자동으로 범위 안으로 조정됩니다.Lemmy: 중첩 댓글 계층 구조와 한도 — 공식 문서는 최상위 댓글, 중첩 답글 계층 구조, 점수 계산 방식(추천 수에서 비추천 수를 뺀 값)을 설명합니다. EveryInfra의 게시물당 댓글 한도는 공식 정렬 옵션이 아닌 자체 설정이며, 한도에 도달했다고 해서 모든 상위·하위 노드가 빠짐없이 포함된다는 보장은 없습니다. · 확인일
sort선택- 게시물을 hot, active, new, top, most_comments, new_comments 중 하나로 정렬합니다. 기본값은 search와 community에서 hot, feed에서 active, comments에서 most_comments입니다.허용 값:
activehotmost_commentsnewnew_commentstop top_range선택- sort가 top일 때만 점수 집계 기간을 설정합니다: hour, sixhour, twelvehour, day, week(기본값), month, threemonths, sixmonths, ninemonths, year, all. 댓글 게시일 필터가 아닙니다.허용 값:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Lemmy 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":"lemmy","action":"search","params":{"keyword":"<keyword>"}}'
Lemmy API 자주 묻는 질문
Lemmy API로 무엇을 가져올 수 있나요?
platform을 lemmy 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 커뮤니티, 뉴스 피드 및 댓글입니다. 각 액션 이름은 서로 다른 Lemmy 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Lemmy search 요청에는 어떤 입력이 필요한가요?
Lemmy search 액션의 검색어를 지정합니다. 검색은 지정한 인스턴스에서 실행되며, 연합된 모든 인스턴스를 빠짐없이 검색한다고 보장하지 않습니다. params 안의 keyword 필드로 전달하세요.
Lemmy search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, body, external_url 및 community입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Lemmy 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.