Search the journalists dataset
Searches the journalists index (dataset id enum value journalists) — public journalist and reporter records crawled from news outlets' own staff/author pages, for PR outreach. Each record carries the outlet, title, best-effort beat topics, and any public contact info found on that outlet's own page, plus deterministic record_type, role_type, email_kind, and outreach-readiness quality signals. There is no cross-outlet upstream search; this dataset is built by crawling a curated roster of outlets ourselves. vertical enum: tech, crypto, marketing, consumer_tech, consumer_policy, cybersecurity, health, gaming, climate, business, entertainment, sports, legal, science, politics, real_estate, automotive, travel, food, education, design, film_tv, fashion, music, personal_finance, tech_independent, culture_independent, local_news, construction, banking, retail, aerospace_defense, energy, agriculture, local_business. contact_type enum: email, social, none. record_type enum: person, desk, organization, syndicated_byline, unknown. role_type enum: staff, editor, reporter, contributor, freelancer, columnist, non_editorial, unknown. email_kind enum: individual_work, individual_personal_public, shared_desk, tips_or_submissions, outlet_generic, unknown. sort enum: relevance, name_asc, outlet_asc, crawled_desc, readiness_desc. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/datasets/journalists/search
- Auth: API key in header x-api-key
Query parameters
Full-text match on the journalist's name, title, and bio, max 256 characters
Exact outlet id filter, e.g. techcrunch, coindesk. Use the ids returned by facets?facet=outlet
Exact beat-vertical filter. Enum: tech, crypto, marketing, consumer_tech, consumer_policy, cybersecurity, health, gaming, climate, business, entertainment, sports, legal, science, politics, real_estate, automotive, travel, food, education, design, film_tv, fashion, music, personal_finance, tech_independent, culture_independent, local_news, construction, banking, retail, aerospace_defense, energy, agriculture, local_business, general_news
Exact topic filter, e.g. security, stablecoins. Use the values returned by facets?facet=topic
Contact-availability filter. Enum: email, social, none
Record classification filter. Enum: person, desk, organization, syndicated_byline, unknown
Role classification filter. Enum: staff, editor, reporter, contributor, freelancer, columnist, non_editorial, unknown
Email semantics filter. Enum: individual_work, individual_personal_public, shared_desk, tips_or_submissions, outlet_generic, unknown
Minimum outreach-readiness score, from 0 to 100
Sort enum: relevance, name_asc, outlet_asc, crawled_desc, readiness_desc
Page number, defaults to 1
Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
Headers
API key required
Response
OK
Example response
{
"code": 200,
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.