# Topics

A topic is what a post is about. We extract topics from the post itself rather than using whatever tags the publication attached.

Use topics to see what a market is talking about, and which publications and people own a conversation.

## Finding a topic

```bash
# The most-covered topics of the last 90 days
curl ... "https://sputnikintelligence.com/api/v1/topics"

# Search by name
curl ... "https://sputnikintelligence.com/api/v1/topics?q=pricing"
```

With no `q` the list is ranked by the last 90 days, which shows you what the conversation is about now. With a `q` it is all-time.

## What a topic detail gives you

```bash
curl ... "https://sputnikintelligence.com/api/v1/topics/<slug>"
```

The publications covering it most, and the people credited on its posts. For the posts:

```
/api/v1/posts?topic=<slug>
```

## Names and slugs

Topic names are lowercase free text, and there are a lot of them. Two topics can have names that look almost identical and still be different rows.

Read the name for display. Pass the slug back as the key.

## Capped, not paged

This index returns at most 100 rows. `next_cursor` is always null, and passing `cursor` gives you an error. Narrow with `q` instead.

`limit` works up to 100. When the cap is hit, `total` comes back null.

The corpus holds over a million topics, and most of them appear on a single post. The first hundred by rank are the ones worth reading.