Skip to main content
GET
게시글 검색·목록

인증

X-RP-API-Key
string
header
필수

헤더

Accept-Language
string

응답 지원 로케일: ko, en, ja, zh-CN, zh-TW, es, fr, de, pt, th, vi. 미지정 시 ko 기본값

예시:

"ko"

쿼리 매개변수

keyword
string

본문 검색어

Maximum string length: 100
companyId
string

검색할 회사 handle

Maximum string length: 255
Pattern: ^[A-Za-z0-9_-]+$
hasImages
boolean

이미지 포함만

hasOg
boolean

Open Graph 포함만

postedAfter
string

게시 시각 ≥ (ISO datetime)

postedBefore
string

게시 시각 ≤ (ISO datetime)

page
integer<int32>

조회할 페이지 번호 (1부터 시작, 기본값 1)

필수 범위: x >= 1
pageSize
integer<int32>

페이지 크기(1~50, 기본 20)

필수 범위: 1 <= x <= 50
sort
enum<string>

정렬 (RELEVANCE: 관련도순(기본), RECENT: 최신순)

사용 가능한 옵션:
RELEVANCE,
RECENT

응답

OK

페이지네이션 응답. page 는 1부터 시작하며, page > totalPages 인 경우 items 는 빈 배열이다.

totalItems
integer<int64>
필수

전체 항목 수

totalPages
integer<int32>
필수

전체 페이지 수

page
integer<int32>
필수

현재 페이지 번호 (1부터 시작)

pageSize
integer<int32>
필수

페이지 크기

items
object[]
필수

현재 페이지 항목