---
title: "All Topics"
method: GET
path: "/api/topics"
tags: ["Topic"]
---

# All Topics

`GET /api/topics`

The topics API returns a list of JSON objects, with each object containing metadata for every topic in the Sefaria database. By default, responses are minified to reduce payload size. Use `minify=0` to get the full topic data including images and all other fields.

## Query parameters

- `limit` integer
- `minify` 0 | 1

## Response `200`

A list of JSON objects, each object representing a topic in the Sefaria database. Please note, since this list is over 30,000 topics long, in the example we only presented the first several topics that are returned in the array. When `minify=0` is specified, the full topic data is returned including images and all other fields.

- TopicJSON[]
  - `slug` string, required — The unique slug for a given topic.
  - `titles` TitlesJSON[], required — An array of JSON objects, each representing an alternative title for the object, in various languages.
    - `text` string — The text of the title
    - `lang` string — The language of the title, either `en` or `he`.
    - `Primary` boolean — A field depicting whether or not the title is the primary title. Note: For any given topics, one should expect two titles with this field present and set to `true`, an English and a Hebrew primary title. The English value with `primary` set to `true` will match the string value of the `primaryTitle` field on topic.
  - `alt_ids` object — This is a dictionary containing the keys of naming schemes, and ids of this topic represented in that naming scheme. It’s used both for canonical names in other naming schemes and temporary storage of names when renaming slugs. All of the data here is for internal use, with the exception of the values `bfo` and `wikidata`. `bfo` refers to [basic formal ontology](https://developers.sefaria.org/docs/topic-ontology), and `wikidata` to the wikidata ontology of topics.
    - `_temp_id` string
  - `properties` TopicPropertyJson — The JSON object containing information about a topic's properties
    - `heNliLink` NLILinkJSON — JSON for storing NLI links related to data in the Sefaria database.
      - `value` string — A link to a corresponding NLI page to learn more.
      - `dataSource` string — The source of the topic data, whether user-created or Sefaria-created.
    - `enNliLink` NLILinkJSON — JSON for storing NLI links related to data in the Sefaria database.
      - `value` string — A link to a corresponding NLI page to learn more.
      - `dataSource` string — The source of the topic data, whether user-created or Sefaria-created.
  - `description` BillingualJSON — A JSON object containing billingual text, both `he` and `en` parallel texts.
    - `en` union — The English field for a JSON object representing billingual text.
      - string
      - boolean
    - `he` union — The Hebrew field for a JSON object representing billingual text.
      - string
      - boolean
  - `categoryDescription` union — A description of the category of this topic
    - string
    - object
  - `displayOrder` integer — The order in which topics are displayed on the Sefaria website, relative to other topics within their same category.
  - `numSources` integer — The number of text sources associated with a topic.
  - `description_published` boolean — A boolean representing whether or not the description was published.
  - `data_source` string — How the topic was generated, whether by Sefaria, a user on a source sheet, or some other source.
  - `image` TopicImgJSON — A JSON object containing the image metadata for topics with images.
    - `image_uri` string — The URL pointing to the image as hosted by Sefaria.
    - `image_caption` BillingualJSON — A JSON object containing billingual text, both `he` and `en` parallel texts.
      - `en` union — The English field for a JSON object representing billingual text.
        - string
        - boolean
      - `he` union — The Hebrew field for a JSON object representing billingual text.
        - string
        - boolean
  - `primaryTitle` BillingualJSON — A JSON object containing billingual text, both `he` and `en` parallel texts.
    - `en` union — The English field for a JSON object representing billingual text.
      - string
      - boolean
    - `he` union — The Hebrew field for a JSON object representing billingual text.
      - string
      - boolean
  - `primaryTitleIsTransliteration` BillingualJSON — A JSON object containing billingual text, both `he` and `en` parallel texts.
    - `en` union — The English field for a JSON object representing billingual text.
      - string
      - boolean
    - `he` union — The Hebrew field for a JSON object representing billingual text.
      - string
      - boolean

---

[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)