Products

Overview

The Products resource provides fake product data with names, prices, descriptions, and categories.

Endpoints

Available Endpoints

Method	Endpoint	Description
GET	/v1/products	List all products
GET	/v1/products/:id	Get a specific product

Product Object

{
  "id": 1,
  "name": "Ergonomic Rubber Keyboard",
  "description": "Carbonite neutralizes our open-source, virtual RAM drive.",
  "price": 299.99,
  "category": "smartphones",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-15T10:30:00.000Z"
}

Field	Type	Description
id	number	Unique identifier
name	string	Product name
description	string	Product description
price	number	Product price
category	string	Product category
createdAt	string	ISO 8601 timestamp
updatedAt	string	ISO 8601 timestamp

List Products

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

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
q	string	—	Search query
fields	string	—	Fields to return
name	string	—	Filter by name
category	string	—	Filter by category

Response

{
  "data": [
    {
      "id": 1,
      "name": "Ergonomic Rubber Keyboard",
      "description": "Carbonite neutralizes our open-source, virtual RAM drive.",
      "price": 299.99,
      "category": "smartphones"
    }
  ],
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 20,
    "totalPages": 5
  }
}

Get Product by ID

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

Response

{
  "data": {
    "id": 1,
    "name": "Ergonomic Rubber Keyboard",
    "description": "Carbonite neutralizes our open-source, virtual RAM drive.",
    "price": 299.99,
    "category": "smartphones"
  }
}

Examples

Search Products

curl "https://api.phantomjson.app/v1/products?q=keyboard"

Filter by Category

curl "https://api.phantomjson.app/v1/products?category=smartphones"

Filter by Price Range

curl "https://api.phantomjson.app/v1/products?price[gte]=50&price[lte]=200"

Sort by Price

# Cheapest first
curl "https://api.phantomjson.app/v1/products?sort=price:asc"

# Most expensive first
curl "https://api.phantomjson.app/v1/products?sort=price:desc"

Field Selection

curl "https://api.phantomjson.app/v1/products?fields=id,name,price,category"

Combined Query

# Cheap smartphones sorted by price
curl "https://api.phantomjson.app/v1/products?category=smartphones&price[lte]=500&sort=price:asc&fields=id,name,price"

Categories

Available product categories:

• smartphones
• laptops
• tablets
• accessories
• cameras
• audio

Relations

• Products are standalone resources with no relationships to other endpoints.