Datasets

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).

get/datasets/journalists/search

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

qstring

Full-text match on the journalist's name, title, and bio, max 256 characters

outletstring

Exact outlet id filter, e.g. techcrunch, coindesk. Use the ids returned by facets?facet=outlet

vertical'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 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

topicstring

Exact topic filter, e.g. security, stablecoins. Use the values returned by facets?facet=topic

contact_type'email' | 'social' | 'none'

Contact-availability filter. Enum: email, social, none

record_type'person' | 'desk' | 'organization' | 'syndicated_byline' | 'unknown'

Record classification filter. Enum: person, desk, organization, syndicated_byline, unknown

role_type'staff' | 'editor' | 'reporter' | 'contributor' | 'freelancer' | 'columnist' | 'non_editorial' | 'unknown'

Role classification filter. Enum: staff, editor, reporter, contributor, freelancer, columnist, non_editorial, unknown

email_kind'individual_work' | 'individual_personal_public' | 'shared_desk' | 'tips_or_submissions' | 'outlet_generic' | 'unknown'

Email semantics filter. Enum: individual_work, individual_personal_public, shared_desk, tips_or_submissions, outlet_generic, unknown

min_outreach_readinessinteger

Minimum outreach-readiness score, from 0 to 100

sort'relevance' | 'name_asc' | 'outlet_asc' | 'crawled_desc' | 'readiness_desc'

Sort enum: relevance, name_asc, outlet_asc, crawled_desc, readiness_desc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.