JSONPlaceholder API

Endpointhttps://jsonplaceholder.typicode.com

Get all posts

GET

https://jsonplaceholder.typicode.com

/posts

Retrieve a list of all posts

Get all posts › Responses

200

Successful response

object[]

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

GET/posts

curl --request GET \
  --url https://jsonplaceholder.typicode.com/posts

shell

Example Responses

[
  {
    "id": 0,
    "userId": 0,
    "title": "title",
    "body": "body"
  }
]

json

application/json

Create a post

POST

https://jsonplaceholder.typicode.com

/posts

Create a new post

Create a post › Request Body

userId

integer · required

The ID of the user creating the post

title

string · required

The title of the post

body

string · required

The content of the post

Create a post › Responses

Post created successfully

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

POST/posts

curl --request POST \
  --url https://jsonplaceholder.typicode.com/posts \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": 0,
  "title": "title",
  "body": "body"
}
'

shell

Example Request Body

{
  "userId": 0,
  "title": "title",
  "body": "body"
}

json

Example Responses

{
  "id": 0,
  "userId": 0,
  "title": "title",
  "body": "body"
}

json

application/json

Get post by ID

GET

https://jsonplaceholder.typicode.com

/posts/{id}

Retrieve a specific post by its ID

Get post by ID › path Parameters

id

integer · required

Post ID

Get post by ID › Responses

Successful response

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

GET/posts/{id}

curl --request GET \
  --url https://jsonplaceholder.typicode.com/posts/:id

shell

Example Responses

{
  "id": 0,
  "userId": 0,
  "title": "title",
  "body": "body"
}

json

application/json

Update post

PUT

https://jsonplaceholder.typicode.com

/posts/{id}

Update an existing post

Update post › path Parameters

id

integer · required

Post ID

Update post › Request Body

userId

integer · required

The ID of the user creating the post

title

string · required

The title of the post

body

string · required

The content of the post

Update post › Responses

Post updated successfully

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

PUT/posts/{id}

curl --request PUT \
  --url https://jsonplaceholder.typicode.com/posts/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": 0,
  "title": "title",
  "body": "body"
}
'

shell

Example Request Body

{
  "userId": 0,
  "title": "title",
  "body": "body"
}

json

Example Responses

{
  "id": 0,
  "userId": 0,
  "title": "title",
  "body": "body"
}

json

application/json

Delete post

DELETE

https://jsonplaceholder.typicode.com

/posts/{id}

Delete an existing post

Delete post › path Parameters

id

integer · required

Post ID

Delete post › Responses

Post deleted successfully

No data returned

DELETE/posts/{id}

curl --request DELETE \
  --url https://jsonplaceholder.typicode.com/posts/:id

shell

Example Responses

No example specified for this content type

Get post comments

GET

https://jsonplaceholder.typicode.com

/posts/{id}/comments

Retrieve all comments for a specific post

Get post comments › path Parameters

id

integer · required

Post ID

Get post comments › Responses

200

Successful response

object[]

id

integer · required

The comment ID

postId

integer · required

The ID of the post this comment belongs to

name

string · required

The name of the commenter

email

string · email · required

The email of the commenter

body

string · required

The content of the comment

GET/posts/{id}/comments

curl --request GET \
  --url https://jsonplaceholder.typicode.com/posts/:id/comments

shell

Example Responses

[
  {
    "id": 0,
    "postId": 0,
    "name": "name",
    "email": "test@example.com",
    "body": "body"
  }
]

json

application/json

Get all posts

GET

https://jsonplaceholder.typicode.com

/posts

Retrieve a list of all posts

Get all posts › Responses

200

Successful response

object[]

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

Create a post

POST

https://jsonplaceholder.typicode.com

/posts

Create a new post

Create a post › Request Body

userId

integer · required

The ID of the user creating the post

title

string · required

The title of the post

body

string · required

The content of the post

Create a post › Responses

Post created successfully

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

Get post by ID

GET

https://jsonplaceholder.typicode.com

/posts/{id}

Retrieve a specific post by its ID

Get post by ID › path Parameters

id

integer · required

Post ID

Get post by ID › Responses

Successful response

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

Update post

PUT

https://jsonplaceholder.typicode.com

/posts/{id}

Update an existing post

Update post › path Parameters

id

integer · required

Post ID

Update post › Request Body

userId

integer · required

The ID of the user creating the post

title

string · required

The title of the post

body

string · required

The content of the post

Update post › Responses

Post updated successfully

id

integer · required

The post ID

userId

integer · required

The ID of the user who created the post

title

string · required

The title of the post

body

string · required

The content of the post

Get post comments

GET

https://jsonplaceholder.typicode.com

/posts/{id}/comments

Retrieve all comments for a specific post

Get post comments › path Parameters

id

integer · required

Post ID

Get post comments › Responses

200

Successful response

object[]

id

integer · required

The comment ID

postId

integer · required

The ID of the post this comment belongs to

name

string · required

The name of the commenter

email

string · email · required

The email of the commenter

body

string · required

The content of the comment