Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Resolve a person, organization, place, or company by free-text name. Returns ranked candidates with the canonical slug you should feed into entity-aware tools. Use this first whenever you only have a human name. The slug is the stable handle — once resolved, downstream tools that take entity_slug accept it directly without re-resolving. For companies that you can identify by ticker, domain, CIK, or QID, prefer companies/resolve_company — it has more identifier surface.

​
Inputs

FieldTypeRequiredDefaultDescription
querystringyes—Free-text name (e.g. "sam altman", "nvidia", "kara swisher"). Case-insensitive.
limitinteger (1–10)no5Maximum candidates to return.

​
Output

A markdown document with an ## Entity matches for "<query>" (N) heading and one ### Name section per result, each with bullet-style **Slug:**, **Description:**, **Wikipedia:** (when present), and — for companies — **Ticker:** / **Domain:** lines. Sample (query="Marc Andreessen", limit=2): 
## Entity matches for "Marc Andreessen" (2)

### Marc Andreessen

**Slug:** marc-andreessen
**Description:** General partner of Andreessen Horowitz
**Wikipedia:** https://en.wikipedia.org/wiki/Marc_Andreessen
### Laura Arrillaga-Andreessen

**Slug:** laura-arrillaga-andreessen
**Description:** American educator ‧ Marc Andreessen's wife
**Wikipedia:** https://en.wikipedia.org/wiki/Laura_Arrillaga-Andreessen
The first result is usually the one you want for unambiguous queries. For ambiguous names (common surnames, multiple people with the same name) read the **Description:** and **Wikipedia:** lines to disambiguate. The string after **Slug:** is what every other tool that takes an entity_slug parameter expects.

​
Example

User: Find every recent podcast where Marc Andreessen is mentioned.

Agent calls: entities/resolve_entity { "query": "Marc Andreessen" }
            → reads "Slug:" line → "marc-andreessen"

Agent calls: podcasts/get_entity_mentions { "entity_slug": "marc-andreessen", "limit": 10 }