---
title: "Alternatives to a product"
method: GET
path: "/alternatives/{slug}.json"
tags: ["Catalog"]
---

# Alternatives to a product

`GET /alternatives/{slug}.json`

## Request

- Base URL: `https://listme.name/api/v1`
- URL: `https://listme.name/api/v1/alternatives/{slug}.json`
- Auth: none required

Other products that share a ranking with this one, best first, with why each is worth considering.

## Path parameters

- `slug` string, required

## Query parameters

- `free` '1'
- `open_source` '1'
- `platform` string
- `limit` integer

## Response `200`

Alternatives to a product

- Alternatives
  - `for` 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.
  - `count` integer
  - `page` string, uri, nullable
  - `alternatives` object[], required
    - `score` number
    - `shared_lists` object[]
    - `why_consider` string
    - `product` ProductBrief
      - `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)