플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Mastodon 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
사용자 게시물user_posts | username에 핸들이나 user@instance를 넣어 Mastodon 계정 하나의 게시물을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
프로필profile | Mastodon 핸들이나 user@instance 주소로 계정 하나의 표시 이름, 전체 handle, 홈 인스턴스, 프로필 링크를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
해시태그hashtag | hashtag에 #을 제외한 값을 넣어 Mastodon 해시태그의 게시물을 탐색합니다. | 요청 1,000개당 $1.39 | 정상 |
인기 급상승trending | Mastodon 인스턴스에서 인기 급상승 중인 게시물을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
타임라인timeline | Mastodon 인스턴스(기본값 fosstodon.org)의 공개 타임라인을 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Mastodon 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
user_posts사용자 게시물
| username | instance | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
profile프로필 Mastodon 핸들이나 user@instance 주소로 계정 하나의 표시 이름, 전체 | username | instance | Sync 응답 | — | 요청 1,000개당 $1.39 | username · display_name · handle · instance · url · platform |
hashtag해시태그
| hashtag | instance | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
trending인기 급상승 Mastodon 인스턴스에서 인기 급상승 중인 게시물을 가져옵니다. | instance | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags | |
timeline타임라인 Mastodon 인스턴스(기본값 fosstodon.org)의 공개 타임라인을 조회합니다. 게시물별 작성자, 본문, 언어, 미디어 링크, 좋아요·부스트·답글 수가 포함됩니다. 로그인한 개인 피드나 Mastodon 전체 아카이브가 아닙니다. | instance | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
Mastodon user_posts 파라미터는 각각 무엇을 의미하나요?
username에 핸들이나 user@instance를 넣어 Mastodon 계정 하나의 게시물을 가져옵니다. 좋아요·부스트·답글 수, 언어, 부스트 여부 플래그가 포함됩니다. 다른 인스턴스의 같은 이름 계정은 별개로 처리됩니다. 전체 기록을 보장하지 않습니다.
username필수- Mastodon 계정 핸들 또는 user@instance 전체 형식을 지정하며, 앞의 @ 기호는 붙여도 되고 생략해도 됩니다. 인스턴스 없이 짧은 핸들만 입력하면 mastodon.social이 기본값으로 적용되며, 인스턴스가 다르면 사용자 이름이 같아도 서로 다른 계정입니다.Mastodon WebFinger: 계정 핸들은 도메인까지 확인해야 한다 — 공식 문서는 @user
@example.com과 @user @example.org가 사용자 이름과 도메인으로 함께 정의되는 별개의 계정이라고 명시합니다. 이 문서는 계정 식별 규칙을 설명할 뿐이며, 이 게이트웨이가 공식 Account 메타데이터를 모두 반환한다는 의미는 아닙니다. · 확인일 instance선택- 스킴이나 경로 없이 Mastodon 인스턴스 도메인을 지정합니다. timeline 액션의 기본값은 fosstodon.org이고, 그 외 액션의 기본값은 mastodon.social입니다. 명시한 instance가 username의 도메인보다 우선하므로 두 값은 일치해야 합니다.
Mastodon profile 파라미터는 각각 무엇을 의미하나요?
Mastodon 핸들이나 user@instance 주소로 계정 하나의 표시 이름, 전체 handle, 홈 인스턴스, 프로필 링크를 확인합니다. instance를 지정하지 않으면 단순 핸들은 mastodon.social에서 조회되며, 일치한다고 해서 의도한 계정이라는 보장은 없습니다.
username필수- Mastodon 계정 핸들 또는 user@instance 전체 형식을 지정하며, 앞의 @ 기호는 붙여도 되고 생략해도 됩니다. 인스턴스 없이 짧은 핸들만 입력하면 mastodon.social이 기본값으로 적용되며, 인스턴스가 다르면 사용자 이름이 같아도 서로 다른 계정입니다.Mastodon WebFinger: 계정 핸들은 도메인까지 확인해야 한다 — 공식 문서는 @user
@example.com과 @user @example.org가 사용자 이름과 도메인으로 함께 정의되는 별개의 계정이라고 명시합니다. 이 문서는 계정 식별 규칙을 설명할 뿐이며, 이 게이트웨이가 공식 Account 메타데이터를 모두 반환한다는 의미는 아닙니다. · 확인일 instance선택- 스킴이나 경로 없이 Mastodon 인스턴스 도메인을 지정합니다. timeline 액션의 기본값은 fosstodon.org이고, 그 외 액션의 기본값은 mastodon.social입니다. 명시한 instance가 username의 도메인보다 우선하므로 두 값은 일치해야 합니다.
Mastodon hashtag 파라미터는 각각 무엇을 의미하나요?
hashtag에 #을 제외한 값을 넣어 Mastodon 해시태그의 게시물을 탐색합니다. 작성자, 본문, 언어, 미디어 링크, 좋아요·부스트·답글 수를 가져옵니다. 게시물은 인스턴스 하나의 태그 타임라인에서 가져오며, 부스트 게시물과 답글 게시물은 제외됩니다. 따라서 페디버스 전체의 대화 규모를 측정하는 데이터가 아닙니다.
hashtag필수- 대상 인스턴스의 해시태그 타임라인을 가져올 주제 태그를 앞의 # 없이 지정합니다. 부스트와 답글은 제외되므로 연합 네트워크 전체 태그를 대표하는 샘플이 아닙니다.Mastodon: 해시태그 스트림과 공개 인스턴스 미리보기 제한 — 공식 문서에 따르면 해시태그 피드는 해당 태그가 포함된 공개 게시물을 가져오며, 태그 경로에는 # 기호를 넣지 않습니다. 공개 미리보기가 비활성화된 인스턴스는 접근이 제한됩니다. Boost와 답글을 제외하는 EveryInfra 파라미터는 이 페이지에 문서화된 것으로, 공식 쿼리 키를 모두 그대로 옮긴 것이 아닙니다. · 확인일
instance선택- 스킴이나 경로 없이 Mastodon 인스턴스 도메인을 지정합니다. timeline 액션의 기본값은 fosstodon.org이고, 그 외 액션의 기본값은 mastodon.social입니다. 명시한 instance가 username의 도메인보다 우선하므로 두 값은 일치해야 합니다.
Mastodon trending 파라미터는 각각 무엇을 의미하나요?
Mastodon 인스턴스에서 인기 급상승 중인 게시물을 가져옵니다. instance로 다른 인스턴스를 지정하지 않으면 mastodon.social을 사용합니다. 게시물별 작성자, 본문, 언어, 미디어, 좋아요·부스트·답글 수가 포함됩니다. 순위와 수치는 호출 시점의 상태입니다. 인기 급상승 알고리즘을 설명하거나 페디버스 전체 순위를 매기지는 않습니다.
instance선택- 스킴이나 경로 없이 Mastodon 인스턴스 도메인을 지정합니다. timeline 액션의 기본값은 fosstodon.org이고, 그 외 액션의 기본값은 mastodon.social입니다. 명시한 instance가 username의 도메인보다 우선하므로 두 값은 일치해야 합니다.
Mastodon timeline 파라미터는 각각 무엇을 의미하나요?
Mastodon 인스턴스(기본값 fosstodon.org)의 공개 타임라인을 조회합니다. 게시물별 작성자, 본문, 언어, 미디어 링크, 좋아요·부스트·답글 수가 포함됩니다. 로그인한 개인 피드나 Mastodon 전체 아카이브가 아닙니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태instance선택- 스킴이나 경로 없이 Mastodon 인스턴스 도메인을 지정합니다. timeline 액션의 기본값은 fosstodon.org이고, 그 외 액션의 기본값은 mastodon.social입니다. 명시한 instance가 username의 도메인보다 우선하므로 두 값은 일치해야 합니다.
Mastodon 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":"mastodon","action":"user_posts","params":{"username":"<username>"}}'
Mastodon API 자주 묻는 질문
Mastodon API로 무엇을 가져올 수 있나요?
platform을 mastodon 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 사용자 게시물, 프로필, 해시태그, 인기 급상승 및 타임라인입니다. 각 액션 이름은 서로 다른 Mastodon 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Mastodon user_posts 요청에는 어떤 입력이 필요한가요?
Mastodon 계정 핸들 또는 user@instance 전체 형식을 지정하며, 앞의 @ 기호는 붙여도 되고 생략해도 됩니다. 인스턴스 없이 짧은 핸들만 입력하면 mastodon.social이 기본값으로 적용되며, 인스턴스가 다르면 사용자 이름이 같아도 서로 다른 계정입니다. params 안의 username 필드로 전달하세요.
Mastodon user_posts 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 text, author_name, author_username 및 author_url입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Mastodon 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.