---
title: "Personalized recommendations"
method: GET
path: "/v1/recommend"
tags: ["Discover"]
---

# Personalized recommendations

`GET /v1/recommend`

## Request

- Base URL: `http://localhost:4000`
- URL: `http://localhost:4000/v1/recommend`
- Auth: one of:
  - HTTP bearer
  - none

Returns API recommendations. If a valid Bearer token is provided and the user has bookmarks, returns personalized results scored by shared category, auth type, API type, pricing type, and description keywords with the user's bookmarked APIs. If no bookmarks or no token, returns random APIs.

Results are in the legacy recommendation format.

## Query parameters

- `limit` integer

## Response `200`

Recommendations

- RecommendResponse
  - `data` LegacyRecommendationItem[]
    - `id` string, uuid
    - `name` string
    - `description` string
    - `auth` string
    - `https` boolean
    - `cors` boolean
    - `link` string, uri
    - `imageUrl` string, uri, nullable: Custom image URL set in the dashboard
    - `categoryId` string: Category name (not ID)
    - `pricing` string
    - `alive` boolean
    - `slug` string: Stable URL slug for this API. Use this when building detail links.

---

[API](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api.md) · [All operations](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/revisions/7f07b9ca718f?raw)