플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Tumblr 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 Tumblr 게시물을 검색합니다. | 요청 1,000개당 $36 | 정상 |
태그tag | Tumblr 태그로 분류된 게시물을 탐색하며, 본문, 게시물 유형, 태그, 노트 수, 블로그 정보를 제공합니다. | 요청 1,000개당 $12.79 | 정상 |
사용자 게시물user_posts | Tumblr 블로그 하나의 게시물을 본문, 게시물 유형, 태그, 노트 수, 게시 시각과 함께 가져옵니다. | 요청 1,000개당 $12.79 | 정상 |
프로필profile | Tumblr 블로그의 이름, 설명, 주소, 최근 게시물 날짜를 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Tumblr 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 Tumblr 게시물을 검색합니다. 본문, 게시물 유형, 태그, 노트 수, 게시한 블로그를 받을 수 있습니다. | keyword | post_type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $36 | id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
tag태그 Tumblr 태그로 분류된 게시물을 탐색하며, 본문, 게시물 유형, 태그, 노트 수, 블로그 정보를 제공합니다. 노트는 좋아요와 리블로그를 합친 총계이며, 태그가 게시물의 실제 주제를 증명하지는 않습니다. | tag | hashtag, post_type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $12.79 | id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
user_posts사용자 게시물 Tumblr 블로그 하나의 게시물을 본문, 게시물 유형, 태그, 노트 수, 게시 시각과 함께 가져옵니다. https 링크가 아닌 블로그의 짧은 이름이나 name.tumblr.com을 전달해야 합니다. 한 번에 아카이브 전체를 가져오지 못할 수 있습니다. | username | post_type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $12.79 | id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
profile프로필 Tumblr 블로그의 이름, 설명, 주소, 최근 게시물 날짜를 조회합니다. 짧은 이름이나 name.tumblr.com을 전달해야 합니다. 메시지, 임시 저장 글, 보호된 블로그는 가져올 수 없습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $1.39 | username · display_name · bio · url · latest_post_at · platform |
Tumblr search 파라미터는 각각 무엇을 의미하나요?
키워드로 Tumblr 게시물을 검색합니다. 본문, 게시물 유형, 태그, 노트 수, 게시한 블로그를 받을 수 있습니다. post_type은 한 번에 하나씩 선택해야 합니다. 비공개 블로그는 제외되며, 일치하는 모든 게시물이 포함된다는 보장은 없습니다.
keyword필수search에 사용할 공개 게시물 검색어입니다.tag액션의 호환용 keyword 입력은 실제로 태그로 조회하므로 동일한 검색 진입점으로 간주할 수 없습니다.Tumblr: 키워드 검색과 태그 페이지의 차이 — 공식 문서는 검색 페이지와 태그 페이지를 구분합니다. 검색 페이지는 단어로 콘텐츠를 찾고, 태그 페이지는 특정 태그가 붙은 게시물을 모아 보여 줍니다. Tumblr 웹 페이지의 블로그 추천, 정렬 옵션, 검색 연산자가 이 엔드포인트에서 자동으로 지원되거나 검증된 파라미터는 아닙니다. · 확인일post_type선택search,tag,user_posts에 사용할 단일 게시물 유형으로, 제한 없음을 뜻하는any또는text,photo,video,quote,link,audio중 하나입니다. 배열이 아니며,profile은 이 필터를 사용하지 않습니다.Tumblr: 노트 수는 게시물 유형과 무관하게 좋아요 수와 다르다 — Tumblr 공식 문서는 노트를 게시물이 받은 좋아요, 리블로그, 댓글을 합친 것으로 정의합니다. 게시물 유형이 바뀌어도 이 엔드포인트의 note_count가 세 가지 지표로 자동으로 나뉘지 않으며, 전체 상호작용 수를 고유 사용자 수로 해석할 수도 없습니다. · 확인일
Tumblr tag 파라미터는 각각 무엇을 의미하나요?
Tumblr 태그로 분류된 게시물을 탐색하며, 본문, 게시물 유형, 태그, 노트 수, 블로그 정보를 제공합니다. 노트는 좋아요와 리블로그를 합친 총계이며, 태그가 게시물의 실제 주제를 증명하지는 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태tag필수tag에 사용할 주제 이름이며, # 접두사는 선택입니다. 공개 태그 콘텐츠를 반환합니다.Tumblr: 태그 검색과 전체 텍스트 키워드 검색의 차이 — 공식 문서에 따르면 태그 페이지는 특정 태그가 추가된 게시물을 모아 정리하고, 검색 페이지는 검색어를 기준으로 결과를 보여 줍니다. 이 항목은 태그의 범위를 설명할 뿐이며, 실시간 색인, 완전한 결과, 웹 인터페이스의 모든 필터 옵션을 보장하지 않습니다. · 확인일hashtag선택tag의 대체 파라미터로,tag보다 우선순위가 낮습니다.post_type선택search,tag,user_posts에 사용할 단일 게시물 유형으로, 제한 없음을 뜻하는any또는text,photo,video,quote,link,audio중 하나입니다. 배열이 아니며,profile은 이 필터를 사용하지 않습니다.
Tumblr user_posts 파라미터는 각각 무엇을 의미하나요?
Tumblr 블로그 하나의 게시물을 본문, 게시물 유형, 태그, 노트 수, 게시 시각과 함께 가져옵니다. https 링크가 아닌 블로그의 짧은 이름이나 name.tumblr.com을 전달해야 합니다. 한 번에 아카이브 전체를 가져오지 못할 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- 블로그 단축 이름 또는 name.tumblr.com 도메인입니다. 이 필드에 https://가 포함된 전체 링크를 전달하지 마세요. 전체 주소는
url에 입력합니다.profile은 공개 블로그 집계 데이터만 조회합니다.Tumblr: 블로그의 리블로그와 원작자 표시 — 공식 문서에 따르면 리블로그는 기존 게시물을 다른 블로그에 올리면서 내용을 덧붙일 수 있게 해 줍니다. 내용을 덧붙인 리블로그는 일반 검색에는 나타날 수 있지만 태그 검색에는 나타나지 않습니다. 이 엔드포인트는 전체 리블로그 체인을 제공하지 않으며, 현재 블로그 정보만으로 원작자를 추정할 수 없습니다. · 확인일 post_type선택search,tag,user_posts에 사용할 단일 게시물 유형으로, 제한 없음을 뜻하는any또는text,photo,video,quote,link,audio중 하나입니다. 배열이 아니며,profile은 이 필터를 사용하지 않습니다.
Tumblr profile 파라미터는 각각 무엇을 의미하나요?
Tumblr 블로그의 이름, 설명, 주소, 최근 게시물 날짜를 조회합니다. 짧은 이름이나 name.tumblr.com을 전달해야 합니다. 메시지, 임시 저장 글, 보호된 블로그는 가져올 수 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- 블로그 단축 이름 또는 name.tumblr.com 도메인입니다. 이 필드에 https://가 포함된 전체 링크를 전달하지 마세요. 전체 주소는
url에 입력합니다.profile은 공개 블로그 집계 데이터만 조회합니다.Tumblr: 기본 블로그, 보조 블로그, 그룹 블로그 — 공식 문서에 따르면 한 계정은 기본 블로그와 함께 보조 블로그를 가질 수 있으며, 보조 블로그는 비밀번호로 보호하거나 여러 사용자가 관리할 수 있습니다. 따라서 블로그 이름이 곧 고유한 개인 신원은 아니며, 이 페이지의 데이터로 비밀번호로 보호된 콘텐츠에 접근하거나 계정 간 관계를 식별할 수는 없습니다. · 확인일
Tumblr 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":"tumblr","action":"search","params":{"keyword":"<keyword>"}}'
Tumblr API 자주 묻는 질문
Tumblr API로 무엇을 가져올 수 있나요?
platform을 tumblr 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 태그, 사용자 게시물 및 프로필입니다. 각 액션 이름은 서로 다른 Tumblr 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Tumblr search 요청에는 어떤 입력이 필요한가요?
search에 사용할 공개 게시물 검색어입니다. tag 액션의 호환용 keyword 입력은 실제로 태그로 조회하므로 동일한 검색 진입점으로 간주할 수 없습니다. params 안의 keyword 필드로 전달하세요.
Tumblr search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 text, post_type, author_username 및 author_name입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Tumblr 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.