There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

List topics

Last updated May 31, 2023

GET /content/api/v2/topics

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Supports paging and filtering.

Required Parameters How to use Description
HubSpot OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.

Optional query string filters & options

If a parameter supports a filter type of 'gt', that means you can append a double underscore to the parameter name to find all items greater than the value. For example, the following query will find all items created than the 'updated' time:
Parameter name Description
limit The number of items to return. Defaults to 20
offset The offset set to start returning rows from. Defaults to 0.
created exact, range, gt, gte, lt, lte
id exact, in
name exact
slug exact

JSON Fields returned in the response

Parameter name Type Description
created long The unix milliseconds timestamp when the topic was created
deleted_at long When the topic was deleted, in milliseconds since the epoch. Zero if the blog post was never deleted. Use a DELETE request to delete the post, do not set this directly.
description string A description of the topic
id string The unique id of the topic
name string The name of the topic
slug string How the topic will appear in the url. The slug will be appended to the blog URL to make the url for the topic page