---
title: "Facet the journalists dataset"
method: GET
path: "/datasets/journalists/facets"
tags: ["Datasets"]
---

# Facet the journalists dataset

`GET /datasets/journalists/facets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/journalists/facets`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `facet` 'outlet' | 'vertical' | 'topic' | 'contact_type' | 'record_type' | 'role_type' | 'email_kind' | 'outreach_readiness_band', required
- `q` string
- `outlet` string
- `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'
- `topic` string
- `contact_type` 'email' | 'social' | 'none'
- `record_type` 'person' | 'desk' | 'organization' | 'syndicated_byline' | 'unknown'
- `role_type` 'staff' | 'editor' | 'reporter' | 'contributor' | 'freelancer' | 'columnist' | 'non_editorial' | 'unknown'
- `email_kind` 'individual_work' | 'individual_personal_public' | 'shared_desk' | 'tips_or_submissions' | 'outlet_generic' | 'unknown'
- `min_outreach_readiness` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsJournalistsFacetResponseDoc
  - `code` integer
  - `data` DatasetsJournalistsFacetResponse
    - `dataset` string
    - `facet` string
    - `items` EsJournalistsFacetItem[]
      - `count` integer
      - `value` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)