---
title: "List products"
method: GET
path: "/products.json"
tags: ["Discovery"]
---

# List products

`GET /products.json`

## Request

- Base URL: `https://listme.name/api/v1`
- URL: `https://listme.name/api/v1/products.json`
- Auth: none required

Every product in a compact form, paged and sorted by slug.

## Query parameters

- `kind` 'app' | 'web' | 'service' | 'resource' | 'book'
- `pricing` 'free' | 'freemium' | 'paid' | 'subscription' | 'one-time' | 'open-source' | 'usage-based' | 'contact'
- `platform` string
- `open_source` '1'
- `free` '1'
- `limit` integer
- `offset` integer

## Response `200`

List products

- ProductPage
  - `total` integer, required
  - `limit` integer
  - `offset` integer
  - `next` string, uri, nullable
  - `products` ProductBrief[], required
    - `slug` string, required
    - `name` string, required
    - `kind` 'app' | 'web' | 'service' | 'resource' | 'book', required
    - `tagline` string
    - `pricing` 'free' | 'freemium' | 'paid' | 'subscription' | 'one-time' | 'open-source' | 'usage-based' | 'contact'
    - `free_to_use` boolean
    - `open_source` boolean
    - `platforms` string[]
    - `formats` string[]
    - `website` string, uri
    - `page` string, uri, required
    - `json` string, uri
    - `cover` string, uri
    - `top_ranking` object
      - `list` string
      - `name` string
      - `rank` integer
      - `of` integer
      - `score` number
    - `connected_to_publisher` boolean: Made by or connected to the publisher; see /methodology.

## Other responses

- `400`: The request was invalid or the item does not exist.
- `404`: The request was invalid or the item does not exist.

---

[API](https://skmtc.dev/listme/apis/listme-name-api.md) · [All operations](https://skmtc.dev/listme/apis/listme-name-api/llms.txt) · [OpenAPI document](https://skmtc.dev/listme/apis/listme-name-api/revisions/c7260c20d722?raw)