TISTORY 메뉴

검색

가이드 본문

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

오픈API 가이드

API가이드 댓글
게시글 댓글 목록 API

단일 게시글에 포함된 댓글 정보를 조회할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/comment/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 입력
postId 포스트 ID
4. Request Parameter (Optional)
파라미터 명 설명 비고
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl "https://www.tistory.com/apis/comment/list \
								 ?access_token=abcdefguhjklmnopqrstuvw \
								 &blogName=sampleUserName"
						
6. Response Description
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
item 댓글 node. 아래는 item 이하
url 블로그 url
secondaryUrl 2차 도메인
totalCount 해당글의 댓글 총 개수
comments 각각의 comment node의 parent node 아래는 comments 이하 comment nodes
id 댓글ID
name 댓글작성자 이름 / 티스토리 닉네임
parentId 부모 댓글 ID 값이 없을 경우 댓글의 답글이 아님
homepage 댓글 작성자의 주소
visibility 승인 여부 0:승인을 기다리는 댓글 / 그 외:승인을 사용하지 않음
open 공개/비공개 여부 Y:공개 / N:비공개
content 댓글 내용
date 댓글 작성 시간 yyyy-mm-dd hh:mi:ss
7. Request Sample

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<item>
								<url>http://oauth.tistory.com/4</url>
								<secondaryUrl></secondaryUrl>
								<postId>4</postId>
								<totalCount>3</totalCount>
								<comments>
									<comment>
										<id>8176918</id>
										<date>1303796711</date>
										<name><![CDATA[지나다가]]></name>
										<parentId></parentId>
										<homepage>http://someurl.com</homepage>
										<visibility>2</visibility>
										<comment><![CDATA[좋은 글 감사합니다.]]></comment>
										<open>Y</open>
									</comment>
									<comment>
										<id>8176923</id>
										<date>1303796801</date>
										<name><![CDATA[글쎄요]]></name>
										<parentId></parentId>
										<homepage>http://shesgone.com</homepage>
										<visibility>2</visibility>
										<comment><![CDATA[제 홈에 와서 구경해보세요^_^]]></comment>
										<open>N</open>
									</comment>
									<comment>
										<id>8176926</id>
										<date>1303796900</date>
										<name><![CDATA[Tistory API]]></name>
										<parentId>8176918</parentId>
										<homepage>http://oauth.tistory.com</homepage>
										<visibility>2</visibility>
										<comment><![CDATA[비루한 글에 칭찬을 하시니 몸둘바를 모르.. 지 않아!]]></comment>
										<open>Y</open>
									</comment>
								</comments>
							</item>
						</tistory>
												

2) JSON

							{
								"tistory":{
									"item":{
										"url":"http://oauth.tistory.com/4",
										"secondaryUrl":"",
										"postId":"4",
										"totalCount":"3",
										"comments": {
											"comment": [
												{
													"id":"8176918",
													"date":"1303796711",
													"name":"지나다가",
													"parentId":"",
													"homepage":"http://someurl.com",
													"visibility":"2",
													"comment":"좋은 글 감사합니다.",
													"open":"Y"
												},
												{
													"id":"8176923",
													"date":"1303796801",
													"name":"글쎄요",
													"parentId":"",
													"homepage":"http://shesgone.com",
													"visibility":"2",
													"comment":" 제 홈에 와서 구경해보세요^_^",
													"open":"N"
												},
												{
													"id":"8176926",
													"date":"1303796900",
													"name":"Tistory API",
													"parentId":"8176918",
													"homepage":"http://oauth.tistory.com",
													"visibility":"2",
													"comment":"비루한 글에 칭찬을 하시니 몸둘바를 모르.. 지 않아!",
													"open":"Y"
												}
											]
										}
									}
								}
							}
						
최근 댓글 목록 API

블로그내 최근 댓글을 조회할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/comment/newest

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개, 최대 10개까지 설정가능
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl "https://www.tistory.com/apis/comment/newest \
								 &access_token=abcdefguhjklmnopqrstuvw \
								 &blogName=sampleUserName"
						
6. Response description
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
item 댓글 node. 아래는 item 이하
url 블로그 url
secondaryUrl 2차 도메인
comments 각각의 comment node의 parent node 아래는 comments 이하 comment nodes
id 댓글ID
name 댓글작성자 이름 / 티스토리 닉네임
homepage 댓글 작성자의 주소
visibility 승인 여부 0:승인을 기다리는 댓글 / 그 외:승인을 사용하지 않음
open 공개/비공개 여부 Y:공개 / N:비공개
content 댓글 내용
link 댓글 full url
date 댓글 작성 시간 yyyy-mm-dd hh:mi:ss
7. Request sample

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<item>
								<url>http://oauth.tistory.com</url>
								<secondaryUrl></secondaryUrl>
								<comments>
									<comment>
										<id>8176926</id>
										<date>1303796900</date>
										<postId>4</postId>
										<name><![CDATA[Tistory API]]></name>
										<homepage>http://oauth.tistory.com</homepage>
										<comment><![CDATA[비루한 글에 칭찬을 하시니 몸둘바를 모르.. 지 않아!]]></comment>
										<open>Y</open>
										<link>http://oauth.tistory.com/4#comment8176926</link>
									</comment>
									<comment>
										<id>8176923</id>
										<date>1303796801</date>
										<postId>4</postId>
										<name><![CDATA[글쎄요]]></name>
										<homepage>http://shesgone.com</homepage>
										<comment><![CDATA[제 홈에 와서 구경해보세요^_^]]></comment>
										<open>N</open>
										<link>http://oauth.tistory.com/4#comment8176923</link>
									</comment>
									<comment>
										<id>8176918</id>
										<date>1303796711</date>
										<postId>4</postId>
										<name><![CDATA[지나다가]]></name>
										<homepage>http://someurl.com</homepage>
										<comment><![CDATA[좋은 글 감사합니다.]]></comment>
										<open>Y</open>
										<link>http://oauth.tistory.com/4#comment8176918</link>
									</comment>
								</comments>
							</item>
						</tistory>
												

2) JSON

							{
								"tistory":{
									"status":"200",
									"item":{
										"url":"http://oauth.tistory.com",
										"secondaryUrl":"",
										"comments":{
											"comment": [
												{
													"id":"8176926",
													"date":"1303796900",
													"postId":"4",
													"name":"Tistory API",
													"homepage":"http://oauth.tistory.com",
													"comment":"비루한 글에 칭찬을 하시니 몸둘바를 모르.. 지 않아!",
													"open":"Y",
													"link":"http://oauth.tistory.com/4#comment8176926"
												},
												{
													"id":"8176923",
													"date":"1303796801",
													"postId":"4",
													"name":"글쎄 요",
													"homepage":"http://shesgone.com",
													"comment":"제 홈에 와서 구경해보세요^_^",
													"open":"N",
													"link":"http://oauth.tistory.com/4#comment8176923"
												},
												{
													"id":"8176918",
													"date":"1303796711",
													"postId":"4",
													"name":"지나다가",
													"homepage":"http://someurl.com",
													"comment":"좋은 글 감사합니다.",
													"open":"Y",
													"link":"http://oauth.tistory.com/4#comment8176918"
												}
											]
										}
									}
								}
							}
						
댓글 작성 API

단일 게시글 및 단일 댓글에 댓글을 작성할 수 있는 API입니다.

1. Request URL

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

2. Request Method

POST

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰 -
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
postId 포스트 ID
content 댓글 내용
4. Request Parameter (Optional)
파라미터 명 설명 비고
parentId 부모 댓글 ID 댓글의 댓글일 경우만 사용
secret 비밀글 여부 1:비밀댓글 / 그외 공개 댓글
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'content=%EA%B8%80%EB%82%B4%EC%9A%A9&' \
								 https://www.tistory.com/apis/comment/write
						
6. Response Description
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
commentUrl 댓글 주소
7. Request Sample

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<commentUrl>http://oauth.tistory.com/4#comment8176976</commentUrl>
							<result>OK</result>
						</tistory>
												

2) JSON

							{
								"tistory": {
									"status":"200",
									"commentUrl":"http://oauth.tistory.com/4#comment8176976",
									"result":"OK"
								}
							}
						
댓글 수정 API

이미 작성된 댓글을 수정할 수 있는 API입니다.

1. Request URL

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

2. Request Method

POST

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰 -
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
postId 포스트 ID
commentId 댓글ID
content 댓글 내용
4. Request Parameter (Optional)
파라미터 명 설명 비고
parentId 부모 댓글 ID 댓글의 댓글일 경우만 사용
secret 비밀글 여부 1:비밀댓글 / 그외 공개 댓글
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'commentId=5876544123' \
								 -F 'content=%EA%B8%80%EB%82%B4%EC%9A%A9&' \
								 https://www.tistory.com/apis/comment/write
						
6. Response Description
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
commentUrl 댓글 주소
7. Request Sample

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<commentUrl>http://oauth.tistory.com/4#comment8176976</commentUrl>
							<result>OK</result>
						</tistory>
												

2) JSON

							{
								"tistory":{
									"status":"200",
									"commentUrl":"http://oauth.tistory.com/4#comment8176976",
									"result":"OK"
								}
							}
						
댓글 삭제 API

댓글을 삭제할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/comment/delete

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 포스트 ID
commentId 댓글ID
4. Request Parameter (Optional)
파라미터 명 설명 비고
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'commentId=5876544123' \
								 https://www.tistory.com/apis/comment/write
						
6. Response Description
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
7. Request Sample

1) XML


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

2) JSON

							{
								"tistory":{
									"status":"200"
								}
							}