| |
AP Classification Upgrades 2022
Introduction
AP Classification began in 2006 with the goal of funneling news content
into newspaper sections. In this major upgrade, we’ve reinvented
Classification for the digital news environment.
In the past, the taxonomy sought to describe the world
of news content at multiple levels of granularity, giving users numerous
entry points to discover content. For every term that matched the
content, we output all of its broader categories to funnel content into
broader sections. These well-meaning goals lead to far too many classification
terms on each item and no clear indication of which were most relevant.
In this release, AP Classification is relaunched with
a new, search- and SEO-friendly taxonomy designed to support digital news
products. Each tag now includes a relevance score that can be used
to filter tags or sort stories in your systems. Only the most salient
and relevant tags are returned. We hope this new approach will make
it easier for you to discover AP content and to use it in your own production
systems.
Important
|
|
This topic describes
changes to the taxonomy structure and terms in the 3.0 release
of AP Taxonomy. The data properties in the AP Media API responses
remain the same, with one small exception for AP
Geography terms, noted below. However, the hierarchy structure
no longer drives classification results because only the actual
match terms are now returned. Make sure to review this topic for
any changes that could impact your client application. |
|
|
|
AP
Subject
The set of subject terms
has been reduced to a more salient collection of topics; redundant,
ambiguous and low-frequency terms have been removed, and relevant,
timely topics have been added, such as Activism,
Diversity, Equity
and inclusion, and Wellness.
Only
subjects that directly match the content are now returned. Broader
topics are no longer returned unless they also match the content directly.
|
Note
|
|
|
If you have used the
ActualMatch=true or rels:direct
value in the past to filter classification results, this is no
longer necessary. Only direct matches are now returned. |
|
|
|
|
For more information, see
Top-Level
Subjects below.
Most gendered sports have
been removed. For example, Men’s
golf and Women’s golf
are deprecated, and both are now mapped to the Golf
term.
Many
closely-related terms are combined into a single term. For example,
the new term Sci-Fi and fantasy
combines the content from Science
fiction and fantasy movies with Science
fiction and fantasy literature. In this case, content about
SciFi TV shows, podcasts, and other formats not covered in the past
are now included.
Events
that drop out of the news cycle and seem unlikely to return are reviewed
and deprecated on a rolling basis.
Top-Level
Subjects
Value |
ID (GUID) |
Business |
c8e409f8858510048872ff2260dd383e |
Climate and environment |
8783d248894710048286ba0a2b2ca13e |
Education |
1af99ec3cb954ff4b349b32d60d0376d |
Entertainment |
16cb0ba3e6d24d97ace39f5a1924669a |
General news |
f25af2d07e4e100484f5df092526b43e |
Health |
cc7a76087e4e10048482df092526b43e |
Lifestyle |
3e37e4b87df7100483d5df092526b43e |
Media |
c188eb1088be10048dceb097165a0203 |
Obituaries |
30c418e4b7644a9eb54409baf55036d1 |
Oddities |
44811870882f10048079ae2ac3a6923e |
Politics |
86aad5207dac100488ecba7fa5283c3e |
Religion |
026a1118e94443a2aacc08a2e70cc77b |
Science |
4bf76cb87df7100483dbdf092526b43e |
Sports |
54df6c687df7100483dedf092526b43e |
Technology |
455ef2b87df7100483d8df092526b43e |
AP
Geography
- World regions (for example, Eastern
Europe, Greater China,
West Africa) have been removed.
Only the following types
of locations are now returned: cities, U.S. states, Canadian provinces,
Australian states and territories, countries, continents, points of
interest and natural features; for example, lakes and mountain ranges.
Place names are often
ambiguous. While we have removed hierarchical roll-up for all classification,
we were concerned that the ambiguity of place names could create confusion.
To resolve this issue, we have introduced a new parent term property
for AP Geography matches only. All AP Geography matches that have
a parent term now have this new property.
JSON Example
"place":
[
{
"code":
"7ab435e87ec110048cf8df092526b43e",
"name":
"Tokyo",
"rels":
["direct"],
"scheme":
http://cv.ap.org/id/,
"creator":
"Machine",
"parentids":
["661be2f07d5b10048250c076b8e3055c"],
"parentnames":
["Japan"],
"relevance":
50,
"locationtype":
{
"code":
"9d26a20b35f0484a891740f8189d4c7b",
"name":
"City"
},
"geometry_geojson":
{
"type":
"Point",
"coordinates":
[
139.5813,
35.61488
]
}
}
]
NewsML-G2 Example
<subject type="cpnat:geoArea" creator="apsubcreator:Machine" qcode="apgeography:5b86bbd082b01004839adf092526b43e"
relevance="60">
<name>Chicago</name>
<broader qcode="apgeography:2c6a186082b010048379df092526b43e">
<name>Illinois</name>
</broader>
</subject>
Location
Type
Value |
Code |
Administrative region |
338c908297b44f1fb670bd656b68e18e |
Autonomous community |
589efdc24aac4de1a319d777f5f89b8c |
Autonomous region |
f512b4dd78ba4f4ba24a3c54c3c59ef6 |
Bay |
a776288fde444763be0349e1fbd5c77c |
Borough |
30f6407ef71943d08409c3addcff1179 |
Canal |
169ef878d9144d6390f4e855549beac5 |
City |
9d26a20b35f0484a891740f8189d4c7b |
Constituent country |
d83e15f769714aab9d49a03eab919128 |
Continent |
976d112cd5c3497ea180aeecab922c6b |
Disputed territory |
ccaa3b23a3964e57af945798a8a551ee |
Former nation |
953a9525c7e7457cb64a136b05565b30 |
Gulf |
05afd5c8de0741eea5c2506a6d886d6b |
Island |
2ef4b4210f64440eaaa4ff3dcaf37d35 |
Island area |
0a9b49a863314cbd86f9f6a1aaec8c4c |
Island group |
d0cb76c4b1af4a71836227c861efab3e |
Lake |
23137ef0d0904c9f97f0ef95ab57e378 |
Nation |
01f56e0e654841eca2e69bf2cbcc0526 |
Ocean |
0bd52df049f3428ba5cf170e2037d13d |
Point of Interest |
682e208076874111911b4c0525017958 |
Province |
84828d1850104a78bb35f5726b8c49aa |
Region |
2b2af0f2d21d45c28e9e5b43a6159057 |
Republic |
f221cb16ced7445ba082bc6e35aa489b |
River |
7fa74af97f7e40bf99a5e971e9a50461 |
Sea |
61bb9878082348469a42017d7ec5533b |
State |
0ae5eb8e00e04295a4fc209c94bfe6ef |
Strait |
5806ed5221074662a381a3ac95e361a6 |
Territory |
b7a0766613394ffda1709e3e433f2de2 |
World region |
424cdfcd69d64fa6869055f7ebf10be4 |
AP
Person
Person
Type
AP Person main categories for named individuals include:
Value |
Description |
ARCHITECT |
People who designed famous buildings |
ARTIST |
Painters, sculptors and others in fine arts |
AUTHOR |
Novelists, poets and other composers of
literary work |
BUSINESS_LEADER |
Company executives and other newsmakers
in the business world |
ENTERTAINMENT_FIGURE |
Famous performers, models, directors and
media personalities |
MOVIE_ACTOR |
Popular film actors |
CELEBRITY_CHEF |
People who are known for their cooking and
typically have a restaurant and/or a TV show |
COMEDIAN |
Famous stand-up comics |
DANCER |
Professional dancers known for performing
on TV shows, in movies or ballets |
DIRECTOR |
Filmmakers |
MISC_ENTERTAINER
|
Famous people in arts or entertainment who
do not fit into another category, such as magicians or film producers |
FASHION_DESIGNER |
Haute Couture and other well-known designers
of clothing, footwear and accessories |
TV_PERSONALITY |
People known mainly for non-acting, non-journalistic
roles on a television program; for example, talk show hosts, reality
contestants and contest judges |
MODEL |
Supermodels and other fashion models making
the news |
MUSICIAN |
Popular performers in the music industry,
such as singers and instrument players |
GOVERNMENT_FIGURE |
People in unelected leadership roles in
government, such as cabinet members, heads of government agencies,
judges, law enforcement officials, military officers and diplomats |
JOURNALIST |
People who write for newspapers, magazines
or news websites or prepare news to be broadcast |
NEWSMAKER |
Newsmaking people who do not fit into other
categories, such as scientists, lawyers, religious leaders, activists,
academics, military personnel, criminals, crime victims and people
who make news because of their relationship to a famous person |
POLITICIAN |
People in policy-making or decision-making
roles in the government of a geopolitical entity, such as senators,
congress people, governors and presidents |
ROYALTY |
People of royal blood or status |
SPORTS_FIGURE |
Athletes participating in professional or
collegiate sports, or in major amateur events; sports managers,
coaches and administrators |
PROFESSIONAL_ATHLETE |
Athletes participating in professional sports |
COACH |
Coaches in professional or collegiate sports |
COLLEGE_ATHLETE |
Athletes participating in collegiate sports |
SPORTS_MANAGEMENT |
Owners of professional sports teams, NCAA
athletic directors and other sports officials in the news |
AP
Organization
US
pro sports. The AP now applies tags for organization terms,
including leagues, conferences, divisions and teams, only for NFL,
MLB, NHL, NBA, WNBA and MLS.
Olympic teams. AP’s terms for every
country's team in the form "Italy Olympic team" have been
deprecated.
Non-US soccer.
The AP now applies sports team and league
terms only for English Premier League, Bundesliga, Serie A, Ligue
1 and La Liga. Relegated teams have been deprecated.
NCAA football and
men's basketball:
The AP previously applied separate terms
for NCAA men's basketball and football teams, excluding other
sports. For example, there were separate terms for "Tennessee
Volunteers men's basketball" and "Tennessee Volunteers
football." There is now only one term: "Tennessee Volunteers."
For cases in which a college had two terms, the URI for the football
term is kept with the new name applied, and the basketball term
is deprecated. For cases in which only a basketball term existed
for the college, that URI is kept and renamed. The new terms apply
to athletes representing the school in all varsity-level sports.
US state governments. The AP previously
applied tags for terms for each state government in the form "Nevada
state government" and selected individual departments, such as
"Nevada State Legislature." Departmental and functional
leaf nodes have been deprecated, leaving just "Nevada state government."
National
military terms. The national military terms in the form “Australian
armed forces” that AP previously maintained have been deprecated.
AP will continue to tag US military branches, but not subordinate
units.
AP
Company
This change was made in March 2022: AP now tags only companies with
primary shares trading on the following five stock exchanges: NYSE (New
York Stock Exchange), NASDAQ, TYO (Tokyo Stock Exchange), TSE (Toronto
Stock Exchange), XETRA (XETRA - Frankfurt); as well as other select privately-held
or publicly-traded companies making the news. If a company trading on
one of those five stock exchanges is also traded on other exchanges, the
additional stock exchange codes
are provided as well.
|
|