TISTORY 메뉴

티스토리를 시작하시려면, 초대장 받기

검색

가이드 본문

티스토리에 대해서 알려드립니다.

오픈API 가이드

API가이드 게시글
최근 게시글 목록 API

최근 게시물 목록을 가져올 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/post/list

2. Request Method

GET/POST

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
4. Request Parameter (Optional)
파라미터 명 설명 비고
page 몇 페이지 생략하면 첫번째 페이지
count 한페이지당 글 수 생략하면 한페이지당 10개, 최대 30개까지 설정가능
categoryId 카테고리ID 생략하면 카테고리 구분없이 출력
sort 정렬방법 id:글번호, date:작성날짜, 생략시 글번호
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
						curl "https://www.tistory.com/apis/post/list \
							 ?access_token=abcdefguhjklmnopqrstuvw \
							 &blogName=sampleUserName"
					
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 200성공
url 이 글 블로그 full url
secondaryUrl 2차 도메인 (if exists)
page 현재 페이지 No
count 한 페이지당 글 수 (이 페이지의 글 수)
totalCount 전체 글 수(페이징 상관없이)
posts 각각의 글 node. 아래는 posts 이하
id 포스트 ID
title 타이틀
postUrl 이 글의 full url
visibility 글의 상태 0: 비공개, 1: 보호, 2: 공개, 3: 발행
categoryId 카테고리 아이디
comments 댓글 수
trackbacks 트랙백 수
date 글 등록 일
7. Request Method

1) XML


					<?xml version="1.0" encoding="utf-8"?>
					<tistory>
						<status>200</status>
						<item>
							<url>http://oauth.tistory.com</url>
							<secondaryUrl></secondaryUrl>
							<page>1</page>
							<count>10</count>
							<totalCount>4</totalCount>
							<posts>
								<post>
									<id>4</id>
									<title><![CDATA[티스토리 OAuth Open API 일단 써보세요!]]></title>
									<postUrl>http://oauth.tistory.com/4</postUrl>
									<visibility>0</visibility>
									<categoryId>0</categoryId>
									<comments>6</comments>
									<trackbacks>0</trackbacks>
									<date>1303796661</date>
								</post>
								<post>
									<id>3</id>
									<title><![CDATA[View에 보냅니다~]]></title>
									<postUrl>http://oauth.tistory.com/3</postUrl>
									<visibility>3</visibility>
									<categoryId>0</categoryId>
									<comments>0</comments>
									<trackbacks>0</trackbacks>
									<date>1303372106</date>
								</post>
								<post>
									<id>2</id>
									<title><![CDATA[View에 보내봅니다.]]></title>
									<postUrl>http://oauth.tistory.com/2</postUrl>
									<visibility>3</visibility>
									<categoryId>0</categoryId>
									<comments>0</comments>
									<trackbacks>0</trackbacks>
									<date>1303372007</date>
								</post>
								<post>
									<id>1</id>
									<title><![CDATA[티스토리 OAuth2.0 API 오픈!]]></title>
									<postUrl>http://oauth.tistory.com/1</postUrl>
									<visibility>0</visibility>
									<categoryId>0</categoryId>
									<comments>0</comments>
									<trackbacks>0</trackbacks>
									<date>1303352668</date>
								</post>
							</posts>
						</item>
					</tistory>
											

2) JSON

						{
							"tistory":{
								"status":"200",
								"item": {
									"url":"http://oauth.tistory.com",
									"secondaryUrl":"",
									"page":"1",
									"count":"10",
									"totalCount":"4",
									"posts": {
										"post":	[
											{
												"id":"4",
												"title":"티스토리 OAuth Open API 일단 써보세요!",
												"postUrl":"http://oauth.tistory.com /4",
												"visibility":"0",
												"categoryId":"0",
												"comments":"6",
												"trackbacks":"0",
												"date":"1303796661"
											},
											{
												"id":"3",
												"title":"View에 보냅니다~",
												"postUrl":"http://oauth.tistory.com /3",
												"visibility":"3",
												"categoryId":"0",
												"comments":"0",
												"trackbacks":"0",
												"date":"1303372106"
											},
											{
												"id":"2",
												"title":"View에 보내봅니다.",
												"postUrl":"http://oauth.tistory.com /2",
												"visibility":"3",
												"categoryId":"0",
												"comments":"0",
												"trackbacks":"0",
												"date":"1303372007"
											},
											{
												"id":"1",
												"title":"티스토리 OAuth2.0 API 오픈!",
												"postUrl":"http://oauth.tistory.com /1",
												"visibility":"0",
												"categoryId":"0",
												"comments":"0",
												"trackbacks":"0",
												"date":"1303352668"
											}
										]
									}
								}
							}
						}
					
게시글 작성하기 API

게시글을 작성할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/post/write

2. Request Method

POST only

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
title 게시글 제목
4. Request Parameter (Optional)
파라미터 명 설명 비고
visibility 글의 상태 0: 비공개, 1: 보호, 2: 공개, 3: 발행, 생략시 비공개
published 발행시간 UNIX_TIMESTAMP() 값을 넣을경우, 해당 날짜에 예약발행 처리
category 카테고리 아이디 생략시 0(분류없음)
content 글 내용
slogan 문자 주소
tag 태그 ,로 구분하며 이어서 입력
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
						curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
							 -F 'blogName=sampleUserName' \
							 -F 'title=sampleTitle' \
							 -F 'content=sampleContent' \
							 https://www.tistory.com/apis/post/write
					
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 200성공
postId 글 번호
url full URL
7. Request Method

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<postId>74</postId>
							<url>http://sampleUrl.tistory.com/74</url>
						</tistory>
											

2) JSON

						{
							"tistory": {
								"status":"200",
								"postId":"74",
								"url":"http://sampleUrl.tistory.com/74"
							}
						}
					
게시글 수정하기 API

작성된 게시글을 수정할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/post/modify

2. Request Method

POST only

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰 -
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
title 게시글 제목
postId 게시글 번호
4. Request Parameter (Optional)
파라미터 명 설명 비고
visibility 글의 상태 0: 비공개, 1: 보호, 2: 공개, 3: 발행
category 카테고리 아이디 생략시 0(분류없음)
content 글 내용
slogan 문자 주소
tag 태그 ,로 구분하며 이어서 입력
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
						curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
							 -F 'blogName=sampleUserName' \
							 -F 'postId=74' \
							 -F 'title=sampleTitle' \
							 -F 'content=sampleContent' \
							 https://www.tistory.com/apis/post/modify
					
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 200성공
postId 글 번호
url full URL
7. Request Method

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<postId>74</postId>
							<url>http://sampleUrl.tistory.com/74</url>
						</tistory>
												

2) JSON

						{
							"tistory": {
								"status":"200",
								"postId":"74",
								"url":"http://sampleUrl.tistory.com/74"
							}
						}
					
글 읽기 API (단일)

단일 게시글을 읽을 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/post/read

2. Request Method

GET/POST

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰 -
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
postId 게시글 번호
4. Request Parameter (Optional)
파라미터 명 설명 비고
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
						curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
							 -F 'blogName=sampleUserName' \
							 -F 'postId=74' \
							 https://www.tistory.com/apis/post/read
					
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 200
id 글 ID
title 글 제목
content 글 내용
categoryId 카테고리 아이디
postUrl 글 Full url
visibility 글의 상태 0: 비공개, 1: 보호, 2: 공개, 3: 발행
acceptComment 댓글허용여부 0:거부, 1:허용
tags 태그 리스트, 하위 tag 목록포함
comments 댓글 수
trackbacks 트랙백 수
date 글 등록 일
7. Request Method

1) XML


					<?xml version="1.0" encoding="utf-8"?>
					<tistory>
						<status>200</status>
						<item>
							<url>http://oauth.tistory.com</url>
							<secondaryUrl></secondaryUrl>
							<id>1</id>
							<title><![CDATA[티스토리 OAuth2.0 API 오픈!]]></title>
							<content><![CDATA[
								안녕하세요 Tistory API 입니다.<br />
								<br />
								이번에 Third-party Developer 용 <b>Tistory OAuth 2.0 API</b> 가 오픈됩니다.<br />
								Tistory 회원이라면, 여러분의 모든 app에 자유롭게 활용하실 수 있습니다.<br />
								<br />
								<div class="imageblock center" style="text-align: center; clear: both;">
								<img src="http://cfile10.uf.tistory.com/image/156987414DAF9799227B34" ></div>
								<br />
								<p></p>
								많은 기대와 사랑 부탁드립니다.&nbsp;<br />
								&nbsp;]]></content>
							<categoryId>0</categoryId>
							<postUrl>http://oauth.tistory.com/1</postUrl>
							<visibility>0</visibility>
							<acceptComment>1</acceptComment>
							<acceptTrackback>1</acceptTrackback>
							<tags>
                                <tag>open</tag>
                                <tag>api</tag>
                            </tags>
							<comments>0</comments>
							<trackbacks>0</trackbacks>
							<date>1303352668</date>
						</item>
					</tistory>
											

2) JSON

						{
							"tistory":{
								"status":"200",
								"item":{
									"url":"http://oauth.tistory.com",
									"secondaryUrl":"",
									"id":"1",
									"title":"티스토리 OAuth2.0 API 오픈!",
									"content":"안녕하세요 Tistory API 입니다.

이번에 Third-party Developer 용 Tistory OAuth 2.0 API 가 오픈됩니다.
Tistory 회원이라면, 여러분의 모든 app에 자유롭게 활용하실 수 있습니다.


많은 기대와 사랑 부탁드립니다. 
 ", "categoryId":"0", "postUrl":"http://oauth.tistory.com/1", "visibility":"0", "acceptComment":"1", "acceptTrackback":"1", "tags : { tag : ["open", "api"] }, "comments":"0", "trackbacks":"0", "date":"1303352668" } } }
파일 첨부 API

파일을 첨부 할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/post/attach

2. Request Method

POST & multipart

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰 -
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
uploadedfile multipart file data
4. Request Parameter (Optional)
파라미터 명 설명 비고
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'uploadedfile=@로컬파일위치' \
								 https://www.tistory.com/apis/post/attach
						
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 200
url 첨부파일 주소
replacer 첨부파일 출력 치환자 글 작성시 치환자를 사용하시기 바랍니다.
7. Request Method

1) XML


							<?xml version="1.0" encoding="utf-8"?>
							<tistory>
								<status>200</status>
								<url>http://cfile22.uf.tistory.com/image/14600B474DB79EFE0B4373</url>
								<replacer>http://cfile22.uf.tistory.com/image/14600B474DB79EFE0B4373</url>
							</tistory>
													

2) JSON

							{
								"tistory": {
									"status":"200",
									"url":"http://cfile6.uf.tistory.com/image/1328CE504DB79F5932B13F",
									"replacer":"%5b%23%23_1N%7ccfile6.uf%401328CE504DB79F5932B13F%7cwidth%3d\"500\"+height%3d\"300\"%7c_%23%23%5d"
								}
							}
						
글 삭제 API

단일 게시글을 삭제할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/post/delete [협의 필요]

2. Request Method

POST only

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰 -
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
postId 게시글 번호
4. Request Parameter (Optional)
파라미터 명 설명 비고
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'postId=12345' \
								 https://www.tistory.com/apis/post/delete
						
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 200 OK
7. Request Method

1) XML


	<?xml version="1.0" encoding="utf-8"?>
	<tistory>
		<status>200</status>
	</tistory>
												

2) JSON

							{
								"tistory" : {
									"status":"200"
								}
							}
						
TISTORY GUIDE 티스토리 사용법을 알려드립니다.