{"uid":"cap_6xkVMK7ddJDlkXZpniUzO","slug":"particle-pro-list-topics-38f6c543","name":"Particle Pro – List Topics","description":"List topics. Returns the hierarchical topic taxonomy.","url":"https://api.particle.pro/v1/topics","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"parent_id":{"type":"string","description":"Get children of this topic. Accepts topic ID, ancestry slug, or ancestry path hash. Omit for top-level roots."},"ancestry_path":{"type":"string","description":"Filter by exact ancestry path hash."},"ancestry_path_prefix":{"type":"string","description":"Filter by ancestry path prefix (all descendants)."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5z2PRaxYYxsSm6grJxGVa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the hierarchical topic taxonomy, supporting navigation by parent, ancestry path, and pagination.","exampleAgentPrompt":"Show me all the top-level topic categories available in Particle Pro, and then list the subtopics under 'Politics'.","exampleUseCases":[{"title":"Browse root-level content categories","prompt":"What are all the top-level topics in Particle Pro's taxonomy? Give me the full list of root categories."},{"title":"Explore subtopics under a parent","prompt":"List all the child topics under the 'Economy' category in Particle Pro — I want to see what subcategories exist under it."},{"title":"Paginate through large topic lists","prompt":"I need to go through all topics under the 'Technology' ancestry path in Particle Pro, 20 at a time — can you start with the first page?"}],"resultDescription":"A paginated list of topic objects from Particle Pro's hierarchical taxonomy, each including a topic ID, name, ancestry slug or path hash, and positional metadata for navigating parent-child relationships. Supports cursor-based pagination for large taxonomies.","failureModes":["Invalid parent_id returns 404 or empty result","Invalid ancestry_path hash returns empty list","Malformed cursor causes pagination error","Exceeding rate limits returns 429","Missing required input wrapper causes 400 validation error"],"whenToPreferThis":"Choose this endpoint when you need to discover or navigate Particle Pro's topic taxonomy — whether listing root-level categories, drilling into children of a specific topic, or filtering by ancestry path. It is the authoritative source for topic structure on Particle Pro, useful before querying topic-scoped content like bills, podcasts, or publisher data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:20.691Z","isFirstParty":false}