datasets_journalists_search
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.
Instructions
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).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text match on the journalist's name, title, and bio, max 256 characters | |
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: relevance, name_asc, outlet_asc, crawled_desc, readiness_desc | |
| topic | No | Exact topic filter, e.g. security, stablecoins. Use the values returned by facets?facet=topic | |
| outlet | No | Exact outlet id filter, e.g. techcrunch, coindesk. Use the ids returned by facets?facet=outlet | |
| vertical | No | 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 | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| role_type | No | Role classification filter. Enum: staff, editor, reporter, contributor, freelancer, columnist, non_editorial, unknown | |
| email_kind | No | Email semantics filter. Enum: individual_work, individual_personal_public, shared_desk, tips_or_submissions, outlet_generic, unknown | |
| record_type | No | Record classification filter. Enum: person, desk, organization, syndicated_byline, unknown | |
| contact_type | No | Contact-availability filter. Enum: email, social, none | |
| min_outreach_readiness | No | Minimum outreach-readiness score, from 0 to 100 |