AP Classification Upgrades 2022

 

ON THIS PAGE      Show

 

 

 

 

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.

 

 

 

 

  • There are now more top-level subjects; for example, Education and Religion. Other changes to top-level subjects include:

    • Arts and entertainment is now Entertainment

    • Environment and nature is now Climate and environment

    • Government and politics is now Politics

    • Social affairs has been removed (some of its children; for example, Education, are now top-level)

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

  • Any person deceased for over two years and deemed not currently newsworthy is now deprecated.

  • Sports figures:

    • Any athlete or coach inactive for over two years is now deprecated. If a sports figure becomes active again or is newsworthy for any other reason (for example, such as in the case of O.J. Simpson), they will be reactivated by the AP.

    • The AP now applies tags for the following:

      • All US pro athletes and coaches on the rosters of the NFL, MLB, NHL, NBA, WNBA and MLS teams.

      • All NCAA football and basketball athletes and coaches on the rosters of the Power Five Conference and Big East teams, plus a short list of priority players and coaches determined by AP’s sports coverage.

      • A priority list of about 100 non-US pro soccer players and coaches determined by AP’s sports coverage.

      • Select F1, NASCAR and IndyCar drivers based on AP's sports coverage.

      • Select golfers, tennis players, cyclists and other professional athletes based on AP's sports coverage.

    • The AP no longer applies tags for complete Olympic rosters for all national teams in favor of a list of priority athletes determined by AP’s sports coverage.

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.

    • National soccer team terms, in the form "Qatar National Soccer Team," now apply only to FIFA World Cup and FIFA Women’s World Cup content.

  • NCAA football and men's basketball:

    • The AP now applies tags for organization terms for teams of schools that compete in the Division I Football Bowl Subdivision (FBS), plus teams in the Big East, Atlantic 10 and West Coast Conference.

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