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

# 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

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.