플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Medium 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Medium 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
tag태그
| tag | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=25. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
user_posts사용자 게시물
| username | url | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=25. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
publication퍼블리케이션
| publication | url | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=25. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
Medium tag 파라미터는 각각 무엇을 의미하나요?
tag에 machine-learning 같은 주제 태그 슬러그를 넣어 해당 태그의 Medium 스토리를 나열합니다. 작성자, 퍼블리케이션, 읽는 시간, 좋아요 및 댓글 수, 멤버 전용 플래그를 가져옵니다. 전문 검색이 아니며 유료 장벽을 우회하지 않습니다. 태그의 모든 스토리가 반환되지 않을 수 있습니다.
tag필수- Medium 주제 태그 슬러그(예: machine-learning)를 지정합니다. 앞의 # 기호는 제거되고, 텍스트는 소문자로 변환되며, 공백은 하이픈으로 바뀝니다. 임의의 전문 검색은 수행하지 않습니다.Medium: 토픽 콘텐츠 피드와 페이월 글의 범위 — Medium 공식 문서는 작성자, 퍼블리케이션, Topic별 콘텐츠 피드 URL을 따로 안내하며, 페이월 뒤의 전체 글은 RSS 피드에 포함되지 않는다고 명시합니다. 이 참고 자료는 객체 유형과 공개된 콘텐츠를 명확히 할 뿐이며, 임의의 전문 검색이나 페이월 글의 전문 조회로 범위를 넓히지 않습니다. · 확인일
Medium user_posts 파라미터는 각각 무엇을 의미하나요?
username에 핸들이나 프로필 URL을 넣어 Medium 작성자 한 명이 게시한 스토리를 수집합니다. 제목, 발췌문, 퍼블리케이션, 읽는 시간, 좋아요 및 댓글 수를 가져옵니다. 임시 저장 글은 제외되며 전체 아카이브를 보장하지 않습니다. 멤버 전용 스토리는 표시되지만 잠금 해제되지 않습니다.
username필수- Medium 작성자 핸들 또는 작성자 프로필 전체 URL을 지정합니다. 핸들만 입력하면 https://medium.com/@<handle> 형식으로 변환하며, 프로필 메타데이터가 아니라 작성자가 발행한 게시물 목록을 가져옵니다.Medium: 박수 수는 순 독자 수가 아니다 — Medium에서는 한 독자가 한 글에 여러 번 박수를 보낼 수 있으므로, 총 박수 수를 순 독자 규모로 볼 수 없습니다. 이 인터페이스는 작성자에게 보이는 사람별 박수 내역을 제공하지 않으며, 필드가 있다고 해서 박수 수가 항상 반환된다는 보장도 없습니다. · 확인일
url선택- user_posts와 publication에서 작성자 또는 퍼블리케이션 전체 URL을 받는 호환용 입력입니다. 필수 파라미터인 username 또는 publication은 반드시 함께 전달해야 합니다. 반환된 게시물 목록에 열람 제한 게시물이 포함될 수 있지만, 유료 구독 전용 본문에 대한 접근 권한이 생기지는 않습니다.
Medium publication 파라미터는 각각 무엇을 의미하나요?
publication에 슬러그나 URL을 넣어 Medium 퍼블리케이션의 스토리를 탐색합니다. 스토리별 작성자, 읽는 시간, 좋아요 및 댓글 수, 멤버 전용 플래그가 포함됩니다. 아티클 제목과 작성자 핸들은 입력으로 사용할 수 없습니다. 멤버 전용 본문은 잠긴 상태로 유지됩니다.
publication필수- 기사 제목이나 작성자 핸들이 아닌 Medium 퍼블리케이션 슬러그 또는 퍼블리케이션 전체 URL을 지정합니다. 슬러그만 입력하면 medium.com/<publication>으로 확장합니다.Medium: 퍼블리케이션과 작성자 페이지는 서로 다른 콘텐츠 피드를 사용한다 — Medium은 Publications와 @username 작성자 페이지를 구분하며, 커스텀 도메인을 사용하는 퍼블리케이션에는 별도의 콘텐츠 피드 형식을 지정합니다. 이 인용은 객체 간 차이를 보여주기 위한 것입니다. 이 인터페이스의 입력은 여전히 위에 명시된 파라미터를 따르며 피드 URL을 전달할 필요가 없고, 모든 커스텀 도메인이 검증되었다고 보장하지 않습니다. · 확인일
url선택- user_posts와 publication에서 작성자 또는 퍼블리케이션 전체 URL을 받는 호환용 입력입니다. 필수 파라미터인 username 또는 publication은 반드시 함께 전달해야 합니다. 반환된 게시물 목록에 열람 제한 게시물이 포함될 수 있지만, 유료 구독 전용 본문에 대한 접근 권한이 생기지는 않습니다.
Medium 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":"medium","action":"tag","params":{"tag":"<tag>"}}'
Medium API 자주 묻는 질문
Medium API로 무엇을 가져올 수 있나요?
platform을 medium 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 태그, 사용자 게시물 및 퍼블리케이션입니다. 각 액션 이름은 서로 다른 Medium 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Medium tag 요청에는 어떤 입력이 필요한가요?
Medium 주제 태그 슬러그(예: machine-learning)를 지정합니다. 앞의 # 기호는 제거되고, 텍스트는 소문자로 변환되며, 공백은 하이픈으로 바뀝니다. 임의의 전문 검색은 수행하지 않습니다. params 안의 tag 필드로 전달하세요.
Medium tag 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, author_name 및 author_username입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Medium 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.