{"uid":"cap_lJK9wtG3P4vo-z8e28gYC","slug":"particle-pro-entity-search-a080abc4","name":"Particle Pro Entity Search","description":"Search entities. Find a person, company, or knowledge graph entity by free-text query — a name, partial name, nickname, stock ticker, @handle, or website domain.","url":"https://api.particle.pro/v1/entities/search","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","required":["q"],"properties":{"q":{"type":"string","description":"Free-text query: a name, partial name, nickname, stock ticker, @handle, or website domain (e.g. 'sam altman', 'coca cola', 'AAPL', '@sama', 'apple.com')."},"type":{"enum":["person","company","knowledge_graph_entity"],"type":"string","description":"Restrict results to one kind. Omit to search people, companies, and knowledge graph entities together."},"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"}}}},"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_aq5SXbkdVLnhLonLO48GX","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":"Search for people, companies, or knowledge graph entities by free-text query including names, tickers, handles, or domains","exampleAgentPrompt":"Search Particle Pro for the entity 'Sam Altman' — I want to find his canonical profile record, restricted to people results.","exampleUseCases":[{"title":"Resolve stock ticker to company entity","prompt":"Look up the company entity for the ticker symbol 'TSLA' on Particle Pro so I can get its canonical ID for further queries."},{"title":"Find person by social handle","prompt":"Search Particle Pro for the person behind the handle '@elonmusk' and return their entity profile."},{"title":"Identify company from domain name","prompt":"I have the domain 'stripe.com' — can you search Particle Pro to find the matching company entity and get its slug?"}],"resultDescription":"Returns a paginated list of matching entity records (people, companies, or knowledge graph entities) with canonical IDs, slugs, display names, and entity type metadata. Supports cursor-based pagination for large result sets.","failureModes":["Empty results when query string doesn't match any indexed entity","Ambiguous results when a name is shared by multiple entities (requires type filter to narrow)","Invalid type enum value returns 400 error","Missing required 'q' query parameter returns 400 error","Rate limiting or payment failure (x402) if USDC balance is insufficient","Cursor expiry causing pagination errors on stale cursors"],"whenToPreferThis":"Use this endpoint when you need to resolve a free-text name, ticker, handle, or domain to a canonical Particle Pro entity record — especially as a first step before calling entity-specific endpoints like Get a Company. Prefer this over the List Entities endpoint when you have a specific search term rather than wanting a full enumeration. Best suited for disambiguation and entity ID resolution workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:10.257Z","isFirstParty":false}