AP Classification Metadata
AP Classification Metadata
AP Classification Metadata
Table of Contents
About This Document.................................................................................................................................................. 3 Whats New................................................................................................................................................................. 3 Subject Classification Authorities ................................................................................................................................. 3 AP Subject .............................................................................................................................................................. 3 AP Category Code .................................................................................................................................................. 4 AP Supplemental Category ..................................................................................................................................... 6 Entity Classification Authorities.................................................................................................................................... 7 AP Party.................................................................................................................................................................. 7 AP Company ........................................................................................................................................................... 8 AP Organization .................................................................................................................................................... 10 AP Geography....................................................................................................................................................... 10 Additional Classification Metadata ............................................................................................................................. 11 ItemContentType................................................................................................................................................... 11 Fixture................................................................................................................................................................... 12
Whats New
Rev. 1.8 1.7 1.6 1.5 1.4 Description The existing stock exchange code NSE is now associated with Nagoya Stock Exchange rather than National Stock Exchange of India, which is now assigned a new code NSI. AP Party properties: Associated State and Team; AP Geography property: Location Type; stock exchanges: ENX, FRA, JASDAQ and LJU; revised numbers of subject categories and AP Party names. Revised AP Company description, new and revised AP company properties (Instrument and Ticker), a list of stock exchange codes and an updated AP ATOM sample. AP Party type: WORLD_CUP_ATHLETE; Item Content Types: Blog, Press Release and Sports Scores. Removed values: top-level subject category Demographic groups and audio Item Content Type Text Only. Top-level subject categories: Arts and entertainment and Media (instead of Entertainment and News Media respectively). New ItemContentType: Game Story. Updated lists of AP Subject category, AP Industry, AP Organization and AP Geography values at the AP Customer Support site. AP Party Types: COMEDIAN and TV_PERSONALITY. AP Organization authority for Entity Classification. Optional latitude and longitude values included in the AP Geography authority for Entity Classification. Top-level subject category values: Demographic groups, Events and Obituaries. AP Geography authority for Entity Classification; a hierarchical list of AP Geography values and a list of AP Fixtures at the AP Customer Support site. AP Category values for broadcast and international text. Additional classification metadata: ItemContentType and Fixture.
AP Subject
Description
A hierarchical subject taxonomy developed by the AP that contains approximately 4,300 subject categories and is applied to all media types. Terms in the first three levels of the hierarchy are available to all AP WebFeeds customers. Additional levels are optional values to which your organization may or may not be entitled. For more information, contact AP Customer Support at [email protected] or 877-836-9477.
AP ATOM Samples
<apcm:SubjectClassification Authority="AP Subject" Value="Business" Id="c8e409f8858510048872ff2260dd383e" /> <apcm:SubjectClassification Authority="AP Subject" Value="Earnings reports" Id="11494c9888fc10048d50ba0a2b2ca13e" />
AP Category Code
Description
AP category codes, which are applied to text, photos and graphics.
e f g h i j k l m n
Stories of state or regional interest under domestic datelines, including general news stories with Washington or international datelines. If a regional item is designed primarily for financial pages, the f category is used, and if it is designed primarily for the sports pages, the s category is used. Weather tables and forecast fixtures. Do not use on weather stories. National political copy. Generally used in months before an election. Use only for result or period score of a single sports event. The code is designed to help newspaper computer systems build a list of scores or ignore individual scores and wait for transmissions that group them. Race wire. Radio network billboards, advisories and scripts. Sports stories, standings and results of more than one event. Travel copy. Television billboards, advisories and scripts. Advisories about stories that may carry any of the category letters. This code is also used for news digests and news advisories. Washington-datelined stories handled by the Washington national news desk. The category code is changed to a or i if a subsequent lead shifts to a different city. Delimited sports (the z-wire). N/A
o p q r s t v w z
International Text
French Service Id a i g Value Arts and entertainment (culture, music, cinema and fixtures on those topics) International news General domestic (French) news: justice, social, brites (short upbeat stories, mostly odd news), some fixtures and general topics. Because stories in the g category cover a wide range of topics, the slug includes a keyword indicating the topic followed by an identifying slug. Slug examples are SOCIAL GREVE SNCF, SOCIAL LICENCIEMENTS, MEDECINE SIDA and SCIENCE GENETIQUE. Digests and advisories Domestic (French) politics Sports Swiss Service Id axx chx ckx fxx gxx inx ixx ksx pxx txx vsx xxx Value Cultural French news Checks/tests Financial news General news Domestic (Swiss) politics International news Culture Political news Social news Miscellaneous Default if no other category is specified
n p s
German Service Id bdx ckx kux plx rsx spx vmx wix xxx Value Picture advertising (rare) Check messages Culture Politics Advisories Sports Miscellaneous Economy Default if no other category is specified
Note AP category codes for both English-language and international text are appended with xx to form three-letter IPTC category codes on international services that conform to IPTC instead of ANPA; for example, ixx, fxx and sxx.
Note AP editors may use multiple category codes separated by spaces; for example, A S.
AP Supplemental Category
Description
AP supplemental category codes, which are applied to photos and graphics.
AP ATOM Sample
<apcm:SubjectClassification Authority="AP Supplemental Category Code" Value="Olympics" Id="OLY" />
Note AP editors may use multiple supplemental category codes separated by spaces; for example, FILE ENT.
AP Party
Description
A list of more than 80,000 names that is continuously maintained and updated with new values. The names are applied to all media types and cover the following areas: Business leaders. A list developed and maintained by AP Information Management. Celebrities. A list developed and maintained by AP Information Management. Newsmakers. A list developed and maintained by AP Information Management. Government and political figures. US House, Senate, Presidential candidates and Governors sourced from AP Elections group; the remainder of the list (world leaders, military leaders, US cabinet and so forth) developed and maintained by AP Information Management. Sports figures. The majority of data sourced from STATS LLC.
Available Properties
Party Type. Main category for each named individual. Team. (For team athletes and coaches only). Associated State. (For US governors and congress members only). Note Associated State is an optional value to which your organization may or may not be entitled. For more information, contact AP Customer Support at [email protected] or 877-836-9477.
ARTIST
AUTHOR BUSINESS_LEADER ENTERTAINMENT_FIGURE CELEBRITY_CHEF COMEDIAN DANCER DIRECTOR MISC_ENTERTAINER MODEL MOVIE_ACTOR MUSICIAN TV_PERSONALITY FASHION_DESIGNER JOURNALIST NEWSMAKER RELATIVE ROYALTY GOVERNMENT_FIGURE POLITICIAN
The Associated Press Continued Id (GUID) c474b8387e4e1004846ddf092526b43e 985054080821499ab05d065a65993b1b a7b366852a2f4a708eb4e269c5beddab 384682bd7b494bab97766d2ab7912388 6fa5f6b37c7145d68a3cff53ac4cc229 00cce0c8923e100483cda55c96277d3e
AP ATOM Samples
<apcm:EntityClassification Authority="AP Party" Value="Daniel Hudson" Id="4c0a16a02bc24d57b8b7d4f25c80cb7f"> <apcm:Property Id="d188b8b8886b100481accb8225d5863e" Name="PartyType" Value="PERSON" /> <apcm:Property Id="384682bd7b494bab97766d2ab7912388" Name="PartyType" Value="PROFESSIONAL_ATHLETE" /> <apcm:Property Id="c474b8387e4e1004846ddf092526b43e" Name="PartyType" Value="SPORTS_FIGURE" /> <apcm:Property Id="4d63f54c6e7a4ac7a7fd7f6a5a87f52e" Name="Team" Value="Arizona Diamondbacks" /> </apcm:EntityClassification> <apcm:EntityClassification Authority="AP Party" Value="Chris Gregoire" Id="9f311450d9c44be681da8eaced062b2b"> <apcm:Property Id="c9d7fa107e4e1004847adf092526b43e" Name="PartyType" Value="POLITICIAN" /> <apcm:Property Id="d188b8b8886b100481accb8225d5863e" Name="PartyType" Value="PERSON" /> <apcm:Property Id="08a0a00882c810048942df092526b43e" Name="AssociatedState" Value="Washington" /> </apcm:EntityClassification>
AP Company
Description
Regularly updated and maintained company and ticker data that is applied to all media types and includes approximately 35,000 companies traded on major exchanges around the world. More than 50 exchanges are covered, including all major US exchanges. For companies that trade on more than one exchange, domestic exchange tickers and ADRs (American Depository Shares) are provided, with exchanges specified for each. This includes non-US companies traded on US exchanges as ADRs (American Depository Shares).
Available Properties
Ticker. Ticker symbol for a security (one or more per company). Exchange. Code for the stock exchange the security is traded on (one or more per company). Instrument. Combination of the exchange and ticker, separated by a colon (one or more per company). APIndustry. One or more APIndustry values from the AP industries vocabulary.
A complete list of all AP Industry values is available in the AP WebFeeds section of the AP Customer Support site at http://customersupport.ap.org.
AP ATOM Sample
Company Example
<apcm:EntityClassification Authority="AP Company" Value="Rio Tinto PLC" Id="3eec602b38284a9da16031df2fb3616a"> <apcm:Property Id="System" Value="Teragram" /> <apcm:Property Name="extid" Value="C000017188" /> <apcm:Property Id="00187f16a84f4ff7835004008024C00a" Name="Ticker" Value="RIO" /> <apcm:Property Id="1a4dca2a65a247d1a2235abff9092eb3" Name="Ticker" Value="RTP" /> <apcm:Property Id="07acf861d13d4e36b3c0eb448d7379ec" Name="Exchange" Value="LSE" /> <apcm:Property Id="b68ceb88f90145449b5af9cf9889a333" Name="Exchange" Value="NYSE" /> <apcm:Property Id="654a794bcc4e7a43502c80df49d3ee94" Name="Instrument" Value="LSE:RIO" /> <apcm:Property Id="324a664fac4c8a49762a40df49d5fe33" Name="Instrument" Value="NYSE:RTP" /> <apcm:Property Id="93ad49da7ca37443bb498926236e5b0a" Name="APIndustry" Value="Metals and minerals" /> <apcm:Property Id="f142fcc5231c704f80f08cb5ecad4692" Name="APIndustry" Value="Materials" /> <apcm:Property Id="511dd198857510048d0fff2260dd383e" Name="APSubject" Value="Industries" /> <apcm:Property Id="c8e409f8858510048872ff2260dd383e" Name="APSubject" Value="Business" /> </apcm:EntityClassification>
AP Organization
Description
Names of organizations or groups (other than companies), such as government departments, non-profits, political groups and sports teams.
AP Organization Values
For a hierarchical list of AP Organization values, refer to the AP WebFeeds section of the AP Customer Support site at http://customersupport.ap.org.
AP ATOM Sample
<apcm:EntityClassification Authority="AP Organization" Value="United States Department of Defense" Id="99891370892110048b7bdcd60602cf03" />
AP Geography
Description
A hierarchical taxonomy of geographic entities that contains more than 2,000 terms and is applied to all media types. Geographic entities include continents, world regions, countries, territories, US states, Canadian provinces and major cities. Only locations relevant to the content are applied; passing references to locations do not result in a tag.
AP Geography Values
For a hierarchical list of AP Geography values, refer to the AP WebFeeds section of the AP Customer Support site at http://customersupport.ap.org.
Available Properties
Location Type. Generic type label, such as City, Country or Region. Latitude and Longitude. Centroid coordinates. Note Location Type, Latitude and Longitude are optional values to which your organization may or may not be entitled. For more information, contact AP Customer Support at [email protected] or 877-836-9477.
10
AP ATOM Sample
<apcm:EntityClassification Authority="AP Geography" Value="Washington" Id="08a0a00882c810048942df092526b43e"> <apcm:Property Id="0ae5eb8e00e04295a4fc209c94bfe6ef" Name="LocationType" Value="State" /> <georss:point xmlns:georss="http://www.georss.org/georss">38.8951100000 -77.0363700000</georss:point> </apcm:EntityClassification>
ItemContentType Values
Text
Value Advisory Agate Analysis AP Impact Blog Description A message to customers and members, not for publication. Statistical sports and financial market data. Stories specifically headlined "AP News Analysis" with rules already established by News. A story designated by a senior editor as an "AP Impact" story. Content that is presented as a web log, with content created by one or more people, usually maintained by one person. May provide commentary or news on a particular subject or may function as a more personal online diary. A regular feature written by the same person or a substitute about a specific subject or topic, with or without an opinion included. A list of upcoming events. An AP story or member pick-up that is not focused on a breaking news angle, but is a feature, workup or trend story. Long headlines with links to full text of the top stories, as chosen by editors in a particular category. Continued on next page
11
AP Classification Metadata Reference Guide Continued Description An item filed with daily, weekly or monthly regularity (for example, Farm Scene). Excludes "Columns." Sports stories about a particular game or sporting event. Short headlines with links to full text of the top stories, as chosen by editors in a particular category. A story previewing an upcoming, scheduled event. The first two paragraphs and links to full text and associated photos of the top stories, as chosen by editors in a particular category. A spot story about the death of a person. Raw data to support a poll or survey. A text or multi-media item providing non-journalistic information to the news media from a PR, government or corporate organization. A biography of a person or a company. A review of a book, play, concert or other cultural event. The first paragraph and links to full text and associated photos of the top stories, as chosen by editors in a particular category. A secondary item in support of another story offering background, secondary angles or history. An item containing in-progress or end of game scoring statistical information. A report on an event or news item that happened today, or that we are learning about today that should be reported ASAP. As much as 90% of Associated Press content falls into this category. Transcripts or excerpts. A prediction of future weather.
Value Fixture Game Story HeadlinePackage Lookahead NewsBrief Obituary Poll/Survey Press Release Profile Review ShortNewsBrief Sidebar Sports Scores Spot Development Transcript/Verbatim Weather Forecast
Audio
Value Actuality Music Question and Answer Session Raw Sound Response to a Question Scener Voicer Wrap Description An audio recording of a newsmaker talking, also known as a sound bite. An audio recording of music only. An audio recording of an interview, typically between a producer and a correspondent or stringer, about stories they are covering. An audio recording of nonverbal sounds, also known as natural sound, ambient sound, or production sound. An audio recording of a newsmaker responding to a question. An audio correspondent report recorded at the scene of a news event. The reporter does the report with the sounds of the event audible in the background. An audio correspondent report in which you hear only the voice of the correspondent. An audio correspondent report that incorporates the voices of both correspondent and newsmaker. Generally, the reporter introduces the newsmaker, the newsmaker says a few words, and the reporter then finishes out the story.
AP ATOM Sample
<apcm:ItemContentType>Spot Development</apcm:ItemContentType>
Fixture
Description
Identifies named sets of regularly occurring content, with a predictable focus, where standardizing the name enables more effective search or product creation. For a list of AP Fixtures, refer to the AP WebFeeds section of the AP Customer Support site at http://customersupport.ap.org.
AP ATOM Sample
<apcm:Fixture Id="ca8e257decd54dad9043bd8df5655b39">Financial Impact</apcm:Fixture>
12