Skip to main content
GET
Find research sources by name, domain, or source ID

Authorizations

Authorization
string
header
required

Developer API key created through /auth.md. Never paste it into a retail chat.

Headers

X-Request-ID
string

Stable 1–128 character ID for an idempotent retry. Reuse the same value only for the same logical request.

Maximum string length: 128
Pattern: ^[A-Za-z0-9._~:+/=-]+$

Query Parameters

q
string
Required string length: 1 - 200
source_id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
ticker
string
Required string length: 1 - 32
Pattern: ^[A-Za-z0-9.^-]+$
domain
enum<string>
Available options:
semiconductors_hardware,
software_ai,
biotechnology_pharma,
healthcare,
energy,
financials,
industrials,
consumer,
materials_mining,
communication_media,
real_estate,
utilities
strategy
enum<string>
Available options:
special_situations,
event_driven,
turnaround,
microcap,
small_cap,
compounder,
deep_value,
growth,
activist,
short_research,
international,
distressed
accessType
enum<string>
Available options:
free_public,
free_registration,
freemium,
paid_subscription,
paid_enterprise,
licensed_commercial,
private_permissioned,
unknown,
blocked
acquisitionTier
enum<string>
Available options:
P0_FREE,
P1_FREE,
P0_PAID_WATCH,
P1_PAID_WATCH,
LICENSE_REQUIRED,
PRIVATE_PERMISSIONED,
HOLD,
BLOCKED
researchDensity
enum<string>
Available options:
very_high,
high,
medium,
low,
unknown
professional
boolean
corpusEligible
boolean
freeOnly
boolean
limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Successful read only response

schema_version
string
required
Allowed value: "1"
generated_at
string
required
data
object[]
required
page
object
required