Skip to main content
POST
Search for leads on X now

Authorizations

Authorization
string
header
required

A SuperX API key ("sxk_..."), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.

Body

application/json
keywords
required

Seed ANGLES for the search plan, not the query itself: 2-5 short phrases (2-3 words each) of how the BUYER talks on a normal working day, their workflows, the tools they already pay for, their jargon, a specific symptom. One comma-separated string or a list of strings (a list is joined with commas), 3-300 characters in total. Never the product's own name, never a full sentence, no search operators.

icp_description
string
required

Who counts as a good lead, in one or two sentences: role, domain, and the buying intent or pain that qualifies them.

Required string length: 3 - 500
offer
string

What you are selling, in one sentence: the product or service and what it does. Optional, and the single strongest input: the search plan is written from it, so a search with an offer finds people talking about the problem rather than only people naming the product.

Required string length: 3 - 300
precision
enum<string>
default:discovery

high keeps only confident matches; discovery also returns adjacent ones.

Available options:
high,
discovery
max_leads
integer
default:10
Required range: 1 <= x <= 30
max_post_age_days
integer
default:30

Only posts written within the last N days count. Older matching posts are skipped and counted in freshness.stale_skipped. Use 7 for a pain point or buying intent worth catching while it is fresh, 1-3 for today, 30 for anyone who is simply active.

Required range: 1 <= x <= 90
account_id
string

Which of your accounts to search as. Omit for the main account.

Response

The search finished. leads is empty when nothing qualified, with a note saying so.

data
object
note
string