Topics
tier:standard

Get a topic

Returns a single topic with breadcrumb ancestors and the top direct children by prominence. Children are capped — use /v1/topics?parent_id={id} to paginate beyond the cap.

get/v1/topics/{id}

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/topics/{id}
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Topic ID, ancestry slug (e.g., technology/artificial-intelligence), or ancestry path hash

Response

OK

ancestorsstring[] nullable

Ancestor topic names from root to parent

ancestrystring

Human-readable breadcrumb path (e.g. Business > Technology > AI)

ancestry_pathstring

Hash-based ancestry path for programmatic filtering

episode_countinteger

Number of episodes in this podcast that cover this topic (only populated for /v1/podcasts/{id} topic lists)

idstring required

Unique identifier

namestring required

Topic name

slugstring required

Ancestry-based slug (e.g., technology/artificial-intelligence). Can be used as topic_id.

total_childreninteger required

Total number of direct child topics. May exceed len(children) when truncated; 0 for leaf topics.

Changes

No recorded changes to this operation across all 2 revisions of this API.