Endpoint Playground

Try the Facet the journalists dataset API

Returns distribution counts over the journalists index (dataset id enum value `journalists`), honoring the same filters as search. Facet enum: `outlet`, `vertical`, `topic`, `contact_type`, `record_type`, `role_type`, `email_kind`, `outreach_readiness_band`. `facet=outlet` returns every outlet (up to 1000) in one response; other facets return their top 50 values. Facets are not paginated: `page` and `page_size` are ignored. Dataset Playground requests query indexed data and do not apply proxy routing.

What a live request returned

14 Oct 2026: 232 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/journalists/facets?facet=outlet
Fields with a value in every checked item: value, count

Sample value profiles: count: 1 to 6,506, median 44.

Request: GET /datasets/journalists/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.47 s
Monitored request: GET /datasets/journalists/facets?facet=outlet

Facet the journalists dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/journalists/facets?facet=outlet&vertical=tech&contact_type=email&record_type=person&role_type=staff&email_kind=individual_work" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	outlet	Facet enum: outlet, vertical, topic, contact_type, record_type, role_type, email_kind, outreach_readiness_band
q	string	No		Full-text match on the journalist's name, title, and bio, max 256 characters
outlet	string	No		Exact outlet id filter
vertical	string	No	tech	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
topic	string	No		Exact topic filter
contact_type	string	No	email	Contact-availability filter. Enum: email, social, none
record_type	string	No	person	Record classification filter. Enum: person, desk, organization, syndicated_byline, unknown
role_type	string	No	staff	Role classification filter. Enum: staff, editor, reporter, contributor, freelancer, columnist, non_editorial, unknown
email_kind	string	No	individual_work	Email semantics filter. Enum: individual_work, individual_personal_public, shared_desk, tips_or_submissions, outlet_generic, unknown
min_outreach_readiness	integer	No		Minimum outreach-readiness score, from 0 to 100

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "journalists",
    "facet": "contact_type",
    "items": [
      {
        "value": "email",
        "count": 42
      },
      {
        "value": "social",
        "count": 61
      },
      {
        "value": "none",
        "count": 8
      }
    ]
  }
}

More Datasets endpoints

List stored scraped datasets Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset Facet Apple Podcasts shows dataset Get an Apple Podcasts show from dataset Search Apple Podcasts shows dataset Search the app-charts dataset Search the app-reviews dataset Search the apps-intelligence dataset Facet the BBB businesses dataset All 136 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.journalistsFacetResponseDocDatasets

GET /datasets/journalists/facets

Facet the journalists dataset

Response behavior

- `facet=outlet` returns **every** outlet id (up to `1000`; the registry holds roughly 230) to use as the `outlet` search/item filter, with counts, in a single response. Other facets return their top `50` values. - Facets are not paginated: `page` and `page_size` are accepted for parity with search but ignored, so `page=2` returns the same buckets as `page=1`. - `facet=contact_type` shows whether a record has an email, social handle, or neither. `facet=email_kind`, `facet=record_type`, and `facet=role_type` expose the quality dimensions used to build safer outreach lists. - `facet=outreach_readiness_band` groups records into `ready`, `promising`, `limited`, and `no_contact` prioritization bands. - Returns an empty `items` array (not an error) when the dataset has no data yet.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet enum: outlet, vertical, topic, contact_type, record_type, role_type, email_kind, outreach_readiness_band · allowed: outlet, vertical, topic, contact_type, record_type, role_type, email_kind, outreach_readiness_band

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "journalists",
    "facet": "contact_type",
    "items": [
      {
        "value": "email",
        "count": 42
      },
      {
        "value": "social",
        "count": 61
      },
      {
        "value": "none",
        "count": 8
      }
    ]
  }
}

Endpoint Playground

Try the Facet the journalists dataset API

What a live request returned

14 Oct 2026: 232 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/journalists/facets?facet=outlet
Fields with a value in every checked item: value, count

Sample value profiles: count: 1 to 6,506, median 44.

Request: GET /datasets/journalists/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.47 s
Monitored request: GET /datasets/journalists/facets?facet=outlet

Facet the journalists dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/journalists/facets?facet=outlet&vertical=tech&contact_type=email&record_type=person&role_type=staff&email_kind=individual_work" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	outlet	Facet enum: outlet, vertical, topic, contact_type, record_type, role_type, email_kind, outreach_readiness_band
q	string	No		Full-text match on the journalist's name, title, and bio, max 256 characters
outlet	string	No		Exact outlet id filter
vertical	string	No	tech	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
topic	string	No		Exact topic filter
contact_type	string	No	email	Contact-availability filter. Enum: email, social, none
record_type	string	No	person	Record classification filter. Enum: person, desk, organization, syndicated_byline, unknown
role_type	string	No	staff	Role classification filter. Enum: staff, editor, reporter, contributor, freelancer, columnist, non_editorial, unknown
email_kind	string	No	individual_work	Email semantics filter. Enum: individual_work, individual_personal_public, shared_desk, tips_or_submissions, outlet_generic, unknown
min_outreach_readiness	integer	No		Minimum outreach-readiness score, from 0 to 100

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "journalists",
    "facet": "contact_type",
    "items": [
      {
        "value": "email",
        "count": 42
      },
      {
        "value": "social",
        "count": 61
      },
      {
        "value": "none",
        "count": 8
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.journalistsFacetResponseDocDatasets

GET /datasets/journalists/facets

Facet the journalists dataset

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "journalists",
    "facet": "contact_type",
    "items": [
      {
        "value": "email",
        "count": 42
      },
      {
        "value": "social",
        "count": 61
      },
      {
        "value": "none",
        "count": 8
      }
    ]
  }
}