Subject¶
Subject metadata (meta_type=subject) identifies the concrete primary thing a story is about — a specific incident, institution, project, case, or work — rather than a broad topic area. Articles typically carry one subject tag.
Filter¶
Discover values in your project with subject_categories from Article facets or GET …/articles/metadata/types/subject/values.
Categories¶
| API value | Meaning |
|---|---|
business_entity |
Company, store, or business as the main subject |
community_org |
Nonprofit, club, or community organization |
crime_incident |
Shooting, assault, robbery, arrest, or similar criminal incident |
cultural_work |
Book, film, album, or other creative work |
development_project |
Specific construction or development project |
economy_trend |
Economic indicator, market trend, or industry shift |
election |
Election, campaign, or ballot measure |
environmental_condition |
Pollution, conservation, or environmental impact |
fire_hazard |
Fire, explosion, gas leak, or hazardous material incident |
government_action |
Official vote, approval, denial, appointment, or enforcement action |
health_issue |
Disease outbreak, health study, or medical condition |
housing_property |
Property sale, rental market, or housing transaction |
infrastructure_system |
Road, bridge, utility, or transit system project |
labor_action |
Strike, union action, or labor dispute |
law_policy |
Legislation, regulation, or policy proposal |
legal_case |
Trial, lawsuit, sentencing, appeal, or court filing |
person_profile |
Profile or obituary centered on one person |
place_landmark |
Specific place or landmark |
public_event |
Festival, protest, ceremony, or public gathering |
public_meeting |
Council meeting, hearing, or public forum |
public_official |
Story centered on a specific public official |
public_record_report |
Audit, report, data release, or public record |
public_spending |
Budget, contract award, or public expenditure |
restaurant_bar |
Restaurant or bar as the main subject |
school_institution |
School, district, or university as the main subject |
scientific_discovery |
Research finding or scientific study |
sports_contest |
Specific game, match, or sporting event |
traffic_crash |
Vehicle, pedestrian, or transit crash |
weather_event |
Storm, flood, tornado, drought, heat wave, or similar weather event |
other |
Other concrete subject |