Skip to main content
GET
/
posts
List posts
curl --request GET \
  --url https://jsonplaceholder.typicode.com/posts
[
  {
    "userId": 123,
    "id": 123,
    "title": "<string>",
    "body": "<string>"
  }
]
Overview
  • Returns a list of posts from JSONPlaceholder.
  • No authentication required; perfect for demos of Mintlify Try it out.
When to use
  • Fetch sample content items for demos, prototypes, or to test API flows.
Query parameters
  • _limit (number): Optional. Maximum number of posts to return (1-100). Useful to keep responses short in demos.
Example usage 
- name: List first 5 posts
  method: GET
  path: /posts
  query:
    _limit: 5
  headers:
    Accept: application/json
Response notes
  • Status 200: An array of Post objects with fields id, userId, title, and body.
  • JSONPlaceholder returns static seeded data; repeated calls return the same list unless filtered.
Tips
  • Combine with /comments?postId= to show relationships.
  • Use _limit to keep responses compact for readers.

Query Parameters

​
_limit
integer

Max number of posts to return

Required range: 1 <= x <= 100

Response

200 - application/json

A JSON array of posts

​
userId
integer
​
id
integer
​
title
string
​
body
string