Products API

Product catalog with filtering and sorting. A free mock REST endpoint from DevSeed API for building and testing frontend applications without a real backend.

Base URL

https://www.devseedapi.com/api/v1/ecommerce

Endpoints

GET /ecommerce/products

Product catalog with filtering and sorting.

GET /ecommerce/products/:id

Returns a single record as { success, data }, or a 404 if the id doesn't exist. Supports include and the simulation parameters below.

Write endpoints (simulated)

POST /ecommerce/products
PUT /ecommerce/products/:id
PATCH /ecommerce/products/:id
DELETE /ecommerce/products/:id
  • Writes behave like a real API but nothing is saved: the response shows the record the write would produce, and later reads are unchanged.
  • Send JSON (Content-Type: application/json) with the same fields as a record. id and createdAt are set by the server and ignored if you send them.
  • POST returns 201. PUT needs a full record, PATCH only the fields to change (nested objects are merged), and DELETE returns the deleted record.
  • Invalid bodies return 422 with an errors list (missing or unknown fields, wrong types, ids that point at missing records). An unknown id returns 404. The simulation parameters work on writes too.

Query Parameters

ParameterTypeDescription
pagenumberPage number for pagination
limitnumberNumber of results per page
searchstringSearch across fields. Supports nested fields (e.g., searches name.first, name.last, email).
filterstringFilter by any field using query params. Supports nested fields using dot notation (e.g., address.city=Toronto, name.first=John).
sortstringSort by a field. Supports nested fields using dot notation (e.g., sortBy=name.first&order=asc).
delaynumber (ms)Simulates network latency
errornumber (HTTP code)Force a specific HTTP error
errorRatenumber (0–100)Random API failures by percentage
includestringInclude related data: category, reviews
categoryIdstringFilter by category ID
minPricenumberMinimum price filter
maxPricenumberMaximum price filter

Example Requests

Get all products

GET /ecommerce/products

Get one by ID

GET /ecommerce/products/p1

Pagination

GET /ecommerce/products?page=2&limit=10

Search products

GET /ecommerce/products?search=john

Filter products

GET /ecommerce/products?filter=value

Sort products

GET /ecommerce/products?sortBy=field&order=asc

Include Related Data

GET /ecommerce/products?include=category,reviews
GET /ecommerce/products/p1?include=category,reviews

Create (simulated)

POST /ecommerce/products
Content-Type: application/json

{ ...fields of a products record }

Update fields (simulated)

PATCH /ecommerce/products/p1
Content-Type: application/json

{ ...only the fields to change }

Delete (simulated)

DELETE /ecommerce/products/p1

Simulate slow API

GET /ecommerce/products?delay=2000

Force an error

GET /ecommerce/products?error=500

Random API failures (20%)

GET /ecommerce/products?errorRate=20

Try the API

Live API Console

/ecommerce/products

Missing a field, filter or endpoint? Was this page helpful?

Request an endpoint / give feedback