Likes

Overview

The Likes resource provides fake like data, tracking which users have liked which social posts.

Endpoints

Method	Endpoint	Description
GET	/v1/likes	List all likes
GET	/v1/likes/:id	Get a specific like

Like Object

{
  "id": 1,
  "socialPostId": 1,
  "userId": 2,
  "createdAt": "2026-01-15T11:00:00.000Z"
}

Field	Type	Description
id	number	Unique identifier
socialPostId	number	ID of the liked post
userId	number	ID of the user who liked
createdAt	string	ISO 8601 timestamp

List Likes

curl https://api.phantomjson.app/v1/likes

Query Parameters

Parameter	Type	Default	Description
page	number	1	Page number
limit	number	20	Items per page (max: 100)
sort	string	—	Sort field and direction
fields	string	—	Fields to return
socialPostId	number	—	Filter by post ID
userId	number	—	Filter by user ID

Response

{
  "data": [
    {
      "id": 1,
      "socialPostId": 1,
      "userId": 2,
      "createdAt": "2026-01-15T11:00:00.000Z"
    }
  ],
  "meta": {
    "total": 200,
    "page": 1,
    "limit": 20,
    "totalPages": 10
  }
}

Get Like by ID

curl https://api.phantomjson.app/v1/likes/1

Response

{
  "data": {
    "id": 1,
    "socialPostId": 1,
    "userId": 2,
    "createdAt": "2026-01-15T11:00:00.000Z"
  }
}

Examples

Filter by Post

curl "https://api.phantomjson.app/v1/likes?socialPostId=1"

Filter by User

curl "https://api.phantomjson.app/v1/likes?userId=2"

Sort by Creation Date

# Newest first
curl "https://api.phantomjson.app/v1/likes?sort=createdAt:desc"

# Oldest first
curl "https://api.phantomjson.app/v1/likes?sort=createdAt:asc"

Field Selection

curl "https://api.phantomjson.app/v1/likes?fields=id,socialPostId,userId"

Combined Query

# Likes on post 1 by user 2
curl "https://api.phantomjson.app/v1/likes?socialPostId=1&userId=2"

Relations

• Social Post — Each like belongs to a social post (socialPostId)
• User — Each like belongs to a user (userId)