워드프레스 REST API 400 오류 "요청된 페이지 수가 가능한 페이지 수보다 큽니다" rest_post_invalid_page_number 해결

워드프레스 REST API가 400 rest_post_invalid_page_number(요청된 페이지 수가 가능한 페이지 수보다 큽니다)를 돌려줄 때의 뜻과, per_page 한도, 마지막 페이지를 알아내는 방법을 직접 확인한 결과로 정리했습니다.

워드프레스 REST API로 글 목록을 page 값을 올려 가며 가져오다가 400과 함께 "요청된 페이지 수가 가능한 페이지 수보다 큽니다."(rest_post_invalid_page_number)가 나왔다면, 마지막 페이지를 넘어 요청했다는 뜻입니다. 데이터가 깨진 것이 아니라 "더 가져올 글이 없다"는 신호입니다. 제 사이트에서 실제로 요청해 본 결과와, 같이 자주 만나는 per_page 오류, 마지막 페이지를 알아내는 방법을 정리했습니다.

나오는 오류 세 가지

오류 코드	한국어 문구(제 사이트의 실제 응답)	영어 원문(워드프레스 코어 소스)	상태
`rest_post_invalid_page_number`	요청된 페이지 수가 가능한 페이지 수보다 큽니다.	The page number requested is larger than the number of pages available.	400
`rest_invalid_param` (세부 `rest_out_of_bounds`)	유효하지 않은 파라미터: per_page / per_page은(는) 1 (포함)와(과) 100 (포함) 사이에 있어야만 합니다	Invalid parameter(s): per_page	400
`rest_no_route`	URL과 요청한 메소드에 일치하는 라우트를 찾을 수 없습니다.	No route was found matching the URL and request method.	404

한국어 문구는 사이트 언어가 한국어일 때 나옵니다. 영어 사이트에서는 영어로 나오지만 오류 코드는 같습니다. per_page 한도 문구의 영어 원문은 따로 확인하지 못했습니다.

직접 시험한 결과

2026년 10월 21일에 제 사이트의 글 목록(/wp-json/wp/v2/posts)에 읽기 전용 GET 요청만 보냈습니다. 글을 쓰는 요청은 보내지 않았습니다.

요청	결과
`per_page=10&page=1`	200, 글 10개
`per_page=10&page=2`	200, 글 8개
`per_page=10&page=3` (마지막 페이지 다음)	400, rest_post_invalid_page_number
`per_page=100`	200, 글 18개(한 번에 전부)
`per_page=101`	400, rest_invalid_param
`page=999`	400, rest_post_invalid_page_number
없는 경로 `/wp-json/wp/v2/doesnotexist`	404, rest_no_route
댓글 목록 `/comments?page=999`	200, 빈 목록 [] (오류가 아님)

글 18개를 10개씩 나누면 2페이지인데, 3페이지를 요청하자 오류가 났습니다. 즉 마지막 페이지를 넘어서 요청하는 순간 오류가 납니다.
같은 조건의 댓글 목록은 오류 없이 200과 빈 목록이 왔습니다. 글 목록과 반응이 달라서, 하나로 만든 반복문이 한쪽에서만 멈추지 않을 수 있습니다. 코어 소스의 글과 댓글 컨트롤러 파일을 확인했는데, 이 페이지 오류 코드는 글 컨트롤러에서만 찾았습니다.
per_page는 100까지만 허용됩니다. 공식 문서도 100개로 제한된다고 적고 있고, 101을 보내자 실제로 400이 났습니다.
이 시험의 총 글 수(X-WP-Total)는 18이었고, 이 숫자가 사이트의 전체 글 수와 정확히 같은지는 확인하지 못했습니다.

마지막 페이지를 알아내는 방법

응답 헤더에 X-WP-Total(전체 글 수)과 X-WP-TotalPages(전체 페이지 수)가 들어 있습니다. 워드프레스 공식 문서도 이 두 헤더로 더 가져올 데이터가 있는지 확인하라고 안내합니다. 제 시험에서 확인한 응답은 이렇습니다.

요청	X-WP-Total	X-WP-TotalPages	Link 헤더
`per_page=10&page=1`	18	2	`rel="next"`가 있음
`per_page=10&page=2`	18	2	`rel="prev"`만 있고 next가 없음

즉 마지막 페이지에서는 next 링크가 사라집니다. 반복문의 종료 조건을 "next 링크가 없으면 멈춤"이나 "page가 X-WP-TotalPages와 같아지면 멈춤"으로 두면 오류 없이 끝낼 수 있습니다. 이 종료 조건은 제가 응답을 보고 정리한 것이고, n8n의 페이지 넘김 옵션에 넣어서 시험한 것은 아닙니다.

점검 순서

rest_post_invalid_page_number가 나오면 오류로 처리하지 말고 "마지막 페이지를 지났다"는 종료 신호로 봅니다.
page를 올리기 전에 X-WP-TotalPages를 확인합니다.
per_page는 100 이하로 보냅니다. 글이 100개 이하라면 per_page=100으로 한 번에 가져오는 방법도 있습니다.
rest_no_route(404)가 나오면 주소 경로를 다시 확인합니다. 영구 링크 설정 때문일 가능성은 제가 시험하지 않았습니다.
인증 관련 401 오류는 별도 글 "현재 로그인 상태가 아닙니다" 해결을 보세요.

참고로 제 댓글 답글 워크플로우(설명 글)는 댓글을 per_page=20으로 가져오고 페이지를 넘기지 않아서, 이 오류를 만난 적은 없습니다. 인증 설정은 n8n과 WordPress REST API, Application Password 가이드(영어)에 정리해 두었습니다.

시험하지 못한 것

글 목록과 댓글 목록만 시험했습니다. 페이지(pages), 미디어 등 다른 목록이 같은지는 확인하지 못했습니다.
n8n HTTP Request 노드의 페이지 넘김(Pagination) 옵션에 위 종료 조건을 넣어서 실행해 보지는 않았습니다.
로그인한 상태에서 같은 요청을 보냈을 때의 응답은 확인하지 않았습니다.
한 사이트(WordPress 7.1.3), 한 시점의 결과입니다.

출처 WordPress REST API Handbook, Pagination. 오류 코드와 영어 문구는 제 사이트의 워드프레스 코어 파일에서 확인했습니다.