플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Substack 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드와 일치하는 Substack 뉴스레터를 찾으며, 각 퍼블리케이션의 이름, 핸들, 커스텀 도메인, 언어, 작성자, 인기 게시물을 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
퍼블리케이션publication | 홈페이지 링크로 Substack 퍼블리케이션을 조회해 이름, 핸들, 커스텀 도메인, 언어, 작성자, 인기 게시물, 그리고 공개된 경우 구독자 수를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
퍼블리케이션 게시물publication_posts | Substack 퍼블리케이션의 게시물을 나열합니다. | 요청 1,000개당 $1.39 | 정상 |
게시물 상세 정보post | /p/ 링크로 Substack 게시물 하나를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
댓글comments | Substack 게시물의 댓글을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
프로필profile | 핸들로 Substack 작가의 프로필을 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
노트notes | 뉴스레터와 별도로 관리되는 짧은 게시물인 Substack 작가의 Notes를 수집하며, 각 Note의 본문, 종류, 좋아요 수, 게시 시각을 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Substack 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드와 일치하는 Substack 뉴스레터를 찾으며, 각 퍼블리케이션의 이름, 핸들, 커스텀 도메인, 언어, 작성자, 인기 게시물을 제공합니다. 게시물 본문이 아닌 퍼블리케이션을 기준으로 검색하며, 구독자 수가 null이면 0이 아니라 비공개라는 뜻입니다. | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publication퍼블리케이션 홈페이지 링크로 Substack 퍼블리케이션을 조회해 이름, 핸들, 커스텀 도메인, 언어, 작성자, 인기 게시물, 그리고 공개된 경우 구독자 수를 가져옵니다. 커스텀 도메인은 파싱되지 않을 수 있으므로 링크에 식별 가능한 Substack 핸들이 있어야 하며, 작성자 대시보드의 데이터는 가져오지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publication_posts퍼블리케이션 게시물 Substack 퍼블리케이션의 게시물을 나열합니다. 각 게시물에는 제목, 부제, 작성자, 좋아요 수, 댓글 수, 단어 수, 읽는 시간, 유료 여부가 포함됩니다. | url | content_type, since, until | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
post게시물 상세 정보 /p/ 링크로 Substack 게시물 하나를 읽어 옵니다. 제목, 부제, 본문, 작성자, 퍼블리케이션, 반응 수, 유료 콘텐츠 여부를 받을 수 있습니다. 유료 구독 전용 본문은 열리지 않습니다. 댓글은 별도의 | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
comments댓글 Substack 게시물의 댓글을 가져옵니다. 작성자, 좋아요 수, 답글 수와 답글·고정 댓글·게시물 작성자 본인 댓글 여부 플래그를 받을 수 있습니다. 게시물의 /p/ 링크를 전달하세요. 한 번에 가져온 결과에 전체 대화가 담기지 않을 수 있습니다. | url | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · text · author_name · author_username · like_count · reply_count · reply_to_id · is_reply · is_pinned · is_author · posted_at · platform |
profile프로필 핸들로 Substack 작가의 프로필을 찾습니다. 표시 이름, 소개, 아바타, 연결된 Twitter 사용자 이름, 계정에 연결된 퍼블리케이션을 받을 수 있습니다. 일반 핸들, @핸들 또는 substack.com/@ 링크를 지원합니다. 퍼블리케이션이 아닌 사람에 대한 정보이며, 구독 데이터는 제공하지 않습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $1.39 | user_id · username · display_name · bio · avatar_url · twitter_username · platform · publications |
notes노트 뉴스레터와 별도로 관리되는 짧은 게시물인 Substack 작가의 Notes를 수집하며, 각 Note의 본문, 종류, 좋아요 수, 게시 시각을 제공합니다. 작가 한 명의 Notes만 나열하며 사이트 전체 검색이 아니고, 전체 기록까지 가져오지 못할 수 있습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=25, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · kind · text · author_username · author_name · like_count · posted_at · platform · restacked_post · attachment_urls |
Substack search 파라미터는 각각 무엇을 의미하나요?
키워드와 일치하는 Substack 뉴스레터를 찾으며, 각 퍼블리케이션의 이름, 핸들, 커스텀 도메인, 언어, 작성자, 인기 게시물을 제공합니다. 게시물 본문이 아닌 퍼블리케이션을 기준으로 검색하며, 구독자 수가 null이면 0이 아니라 비공개라는 뜻입니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- Substack 뉴스레터와 퍼블리케이션을 찾기 위한 검색어를 지정합니다. 게시물 본문 전문 검색은 수행하지 않습니다.Substack: 프로필, 퍼블리케이션 사이트, 대시보드 데이터는 분리되어 있다 — Substack은 공개 프로필, 퍼블리케이션 웹사이트, 발행인 대시보드를 따로 문서화합니다. 이 페이지의 검색은 퍼블리케이션 프로필만 찾으며, 공식 대시보드에 독자 관리와 수익 통계가 있다고 해서 이 인터페이스로 해당 분석 데이터를 가져올 수 있는 것은 아닙니다. · 확인일
Substack publication 파라미터는 각각 무엇을 의미하나요?
홈페이지 링크로 Substack 퍼블리케이션을 조회해 이름, 핸들, 커스텀 도메인, 언어, 작성자, 인기 게시물, 그리고 공개된 경우 구독자 수를 가져옵니다. 커스텀 도메인은 파싱되지 않을 수 있으므로 링크에 식별 가능한 Substack 핸들이 있어야 하며, 작성자 대시보드의 데이터는 가져오지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 대상 Substack 리소스 링크를 지정합니다. publication과 publication_posts에는 퍼블리케이션 홈페이지를, post와 comments에는 /p/ 게시물 링크를 사용하세요. publication 액션에는 인식 가능한 Substack 핸들이 포함된 URL이 필요하며(커스텀 도메인은 파싱되지 않을 수 있음), publication_posts는 커스텀 도메인 링크를 그대로 받습니다.Substack: 작성자 페이지와 퍼블리케이션 사이트는 서로 다른 주소 객체다 — Substack 작성자 핸들은 substack.com/@handle에 대응하고, 퍼블리케이션 웹사이트는 subdomain.substack.com을 사용할 수 있습니다. 이 참고 자료는 객체와 주소의 차이를 확인해 줄 뿐이며, 커스텀 도메인 처리 가능 여부는 이 페이지에 있는 해당 액션의 파라미터 규칙을 엄격히 따릅니다. · 확인일
Substack publication_posts 파라미터는 각각 무엇을 의미하나요?
Substack 퍼블리케이션의 게시물을 나열합니다. 각 게시물에는 제목, 부제, 작성자, 좋아요 수, 댓글 수, 단어 수, 읽는 시간, 유료 여부가 포함됩니다. content_type으로 형식을, since와 until로 날짜를 좁힐 수 있습니다. 유료 구독 전용 본문은 잠긴 상태로 유지되며, 한 번에 아카이브 전체를 가져오지 못할 수 있습니다.
url필수- 대상 Substack 리소스 링크를 지정합니다. publication과 publication_posts에는 퍼블리케이션 홈페이지를, post와 comments에는 /p/ 게시물 링크를 사용하세요. publication 액션에는 인식 가능한 Substack 핸들이 포함된 URL이 필요하며(커스텀 도메인은 파싱되지 않을 수 있음), publication_posts는 커스텀 도메인 링크를 그대로 받습니다.
content_type선택- 퍼블리케이션 게시물을 콘텐츠 형식으로 필터링하며, all_types, newsletter_posts_only, podcast_episodes_only, threads_only 중 하나를 사용합니다. 필드 존재 여부는 개별 게시물 링크로 확인해야 하며, 이 값을 설정해도 유료 콘텐츠의 잠금이 해제되지 않습니다.허용 값:
all_typesnewsletter_posts_onlypodcast_episodes_onlythreads_onlySubstack: 글, 오디오, 동영상 형식과 콘텐츠 권한 — Substack은 텍스트, 오디오, 동영상 게시물을 서로 다른 콘텐츠 형식으로 분류하며, 공개 자료와 비공개 글을 엄격히 구분합니다. 이 페이지의 `content_type` 파라미터는 자체 허용값을 사용하며, 동영상 유형을 추가하지 않고 모든 실행 경로에서 필터링과 조회가 검증되었다고 보장하지도 않습니다. · 확인일 since선택- 날짜 범위로 게시물이나 활동 피드를 필터링할 때 사용하는 시작 날짜 문자열을 지정합니다. 프로필 또는 퍼블리케이션의 공통 파라미터에 포함되어 있어도 계정 생성일 필터링이 활성화되지는 않습니다.
until선택- since와 함께 게시물이나 활동 피드를 필터링할 종료 날짜 문자열을 지정합니다. 구독 만료일을 나타내지 않으며, 전체 과거 아카이브 내보내기를 실행하지도 않습니다.
Substack post 파라미터는 각각 무엇을 의미하나요?
/p/ 링크로 Substack 게시물 하나를 읽어 옵니다. 제목, 부제, 본문, 작성자, 퍼블리케이션, 반응 수, 유료 콘텐츠 여부를 받을 수 있습니다. 유료 구독 전용 본문은 열리지 않습니다. 댓글은 별도의 comments 액션으로 가져옵니다.
url필수- 대상 Substack 리소스 링크를 지정합니다. publication과 publication_posts에는 퍼블리케이션 홈페이지를, post와 comments에는 /p/ 게시물 링크를 사용하세요. publication 액션에는 인식 가능한 Substack 핸들이 포함된 URL이 필요하며(커스텀 도메인은 파싱되지 않을 수 있음), publication_posts는 커스텀 도메인 링크를 그대로 받습니다.Substack: 무료 미리보기는 유료 글 전문이 아니다 — Substack에서는 크리에이터가 유료 글의 무료 미리보기와 페이월 위치를 설정할 수 있습니다. 따라서 텍스트가 비어 있지 않다고 해서 전체 콘텐츠를 가져왔다는 증거가 되지 않으며, is_paid를 설정하거나 유료 콘텐츠로 필터링해도 읽기 권한이 생기지는 않습니다. · 확인일
Substack comments 파라미터는 각각 무엇을 의미하나요?
Substack 게시물의 댓글을 가져옵니다. 작성자, 좋아요 수, 답글 수와 답글·고정 댓글·게시물 작성자 본인 댓글 여부 플래그를 받을 수 있습니다. 게시물의 /p/ 링크를 전달하세요. 한 번에 가져온 결과에 전체 대화가 담기지 않을 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 대상 Substack 리소스 링크를 지정합니다. publication과 publication_posts에는 퍼블리케이션 홈페이지를, post와 comments에는 /p/ 게시물 링크를 사용하세요. publication 액션에는 인식 가능한 Substack 핸들이 포함된 URL이 필요하며(커스텀 도메인은 파싱되지 않을 수 있음), publication_posts는 커스텀 도메인 링크를 그대로 받습니다.Substack: 숨겨진 댓글과 삭제된 댓글은 다르다 — Substack의 Reply Rules에서는 작성자가 글 댓글이나 Notes 답글을 영구 삭제하는 대신 숨길 수 있습니다. 공개 결과에 댓글이 없다고 해서 삭제되었다고 단정할 수 없으며, 이 인터페이스에서는 모더레이션 대시보드에 접근하거나 숨겨진 콘텐츠를 복원하거나 규칙을 수정할 수 없습니다. · 확인일
Substack profile 파라미터는 각각 무엇을 의미하나요?
핸들로 Substack 작가의 프로필을 찾습니다. 표시 이름, 소개, 아바타, 연결된 Twitter 사용자 이름, 계정에 연결된 퍼블리케이션을 받을 수 있습니다. 일반 핸들, @핸들 또는 substack.com/@ 링크를 지원합니다. 퍼블리케이션이 아닌 사람에 대한 정보이며, 구독 데이터는 제공하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- profile 또는 notes에 사용할 크리에이터 핸들을 지정하며, 핸들(@ 접두사는 선택) 또는 substack.com/@user 전체 링크를 받습니다. notes 액션은 장문의 퍼블리케이션 게시물이 아니라 크리에이터의 짧은 업데이트를 가져옵니다.Substack: 작성자 핸들, 표시 이름, 공개 프로필 — 고유한 Substack 핸들은 작성자 프로필 URL을 구성하며, 표시 이름과 소개는 별도로 수정할 수 있습니다. 이에 따라 이 페이지는 username과 display_name을 구분하며, 숨겨진 구독이나 좋아요 활동을 읽을 수 있다고 주장하지 않습니다. · 확인일
Substack notes 파라미터는 각각 무엇을 의미하나요?
뉴스레터와 별도로 관리되는 짧은 게시물인 Substack 작가의 Notes를 수집하며, 각 Note의 본문, 종류, 좋아요 수, 게시 시각을 제공합니다. 작가 한 명의 Notes만 나열하며 사이트 전체 검색이 아니고, 전체 기록까지 가져오지 못할 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- profile 또는 notes에 사용할 크리에이터 핸들을 지정하며, 핸들(@ 접두사는 선택) 또는 substack.com/@user 전체 링크를 받습니다. notes 액션은 장문의 퍼블리케이션 게시물이 아니라 크리에이터의 짧은 업데이트를 가져옵니다.Substack: Notes와 Restack이란 무엇인가 — Substack은 Notes를 짧은 형식의 콘텐츠 활동으로, Restack을 Notes 안에서 콘텐츠를 공유하는 기능으로 정의하며, 이를 글 단위의 뉴스레터 발송과 구분합니다. Substack 공식 기능에 게시, 참여, 수익 분석이 있다고 해서 이 Notes 읽기 엔드포인트가 해당 작업이나 지표를 지원하는 것은 아닙니다. · 확인일
Substack 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":"substack","action":"search","params":{"keyword":"<keyword>"}}'
Substack API 자주 묻는 질문
Substack API로 무엇을 가져올 수 있나요?
platform을 substack 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 퍼블리케이션, 퍼블리케이션 게시물, 게시물 상세 정보, 댓글 및 more입니다. 각 액션 이름은 서로 다른 Substack 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Substack search 요청에는 어떤 입력이 필요한가요?
Substack 뉴스레터와 퍼블리케이션을 찾기 위한 검색어를 지정합니다. 게시물 본문 전문 검색은 수행하지 않습니다. params 안의 keyword 필드로 전달하세요.
Substack search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 handle, name, custom_domain 및 bio입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Substack 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.