---
title: "Recommended Topics"
method: GET
path: "/api/recommend/topics/{ref_list}"
tags: ["Topic"]
---

# Recommended Topics

`GET /api/recommend/topics/{ref_list}`

Given a list of `Ref`s this API returns the most used topics associated with them. This is a fast way of identifying potential shared topics amongst disparate `Ref`s.

## Path parameters

- `ref_list` string, required

## Response `200`

Successful response

- RecommendedTopicResponse[]
  - `slug` string — The url slug for the topic.
  - `titles` object — Titles for the topic by language (usually Hebrew & English)
    - `en` string
    - `he` string
  - `count` integer — Number of times the topic appears in the references

---

[API](https://skmtc.net/sefaria/apis/sefaria-api.md) · [All operations](https://skmtc.net/sefaria/apis/sefaria-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sefaria/sefaria-api/revisions/d29296717011/schema)