Searching within specific fields: list of usable metadata

Searching within specific fields: list of usable metadata

Written by Marie Abraham
Last update: Tuesday, Jun 03, 2025

By default, the search includes every field of a document, but you can restrict it to a specific field:

  1. Restriction by word or theme

  2. Restriction by location

  3. Restriction by paper type

  4. Other search restrictions

  5. Find a document using its ID

β€Žβ€Ž β€Ž

1 - Restriction by word or theme

  • Title of a document. The search on a title is a "contains" kind of search.
    Example: title=macron will find all documents with "macron" in the title.

  • all_keywords: keywords and slugs associated with the document. These keywords are displayed in the document viewer panel. This search requires a strict and complete value.
    Example: all_keywords=transport will find documents whose keywords contain "transport"

  • mediatopic: IPTC numerical code associated with the document.
    πŸ‘‰ Complete list of IPTC codes: https://www.iptc.org/std/NewsCodes/treeview/mediatopic/mediatopic-en-GB.html.
    Example: mediatopic=20000888 will show documents with at least one of the IPTC categories being "Cricket".

β€Žβ€Ž β€Ž

2 - Restriction by location

  • country: 3 letter ISO code of the country of the dateline [details on the dateline here].
    πŸ‘‰ List of 3 letter ISO codes : https://www.iso.org/obp/ui/#search/code
    Example : country=IND will find all documents from India.

  • city: Name of the dateline city, usually in English.
    Example: city="hong kong" will find all documents from Hong Kong.

β€Žβ€Ž β€Ž

3 - Restriction by paper type

  • priority=(flash OR alert OR urgent) : To filter alerts and urgents

A search on urgents, for example, will only find urgents that have not yet been replaced by leads. For this reason, this field is more appropriate for real-time news alerts.

  • genreid=afpattribute:XXX : It is also possible to search for documents by article categories.
    Example: genreid=afpattribute:agenda to designate all agenda-type articles.

List of existing AFP paper attributes which work with this formula : agenda ; analysis ; bioexpress ; chrono ; comment ; synopsis ; quote ; gossip ; sidebar ; inquiry ; interview ; team ; factcheck ; factfile ; tables ; indepthstory ; feature ; insight ; article ; profile ; program ; presentation ; QA ; recit ; report ; reperes ; result ; roundup ; testimony

β€Žβ€Ž β€Ž

4 - Other search restrictions

  • creator: first and last name of the main contributor to the document. The kind of search on a creator is "exact", but works with either the name, surname or both.
    Example: creator="Adem Altan" ; creator=Adem ; creator=Altan will find all the pictures taken by Adem Altan that are published on AFP News.

  • channel : To filter on a specific text feed (/wires/MAX for the English news feed).
    Example : channel=/wires/MAX to search for all the articles published in the English news feed.

β€Ž β€Ž

5 - Find a document using its ID

The document ID is located above the document. By clicking on it, you can copy it. You can then find this document by pasting its ID in the search bar under the format http://doc.afp.com/XXXXXXX or XXXXXXX (the last 7 digits).

β€Ž

To find the right content for you, don't hesitate to ask us to help you set up complex searches. Book an appointment here: https://calendly.com/marie-abraham.

πŸ”— Further reading: All about the search tool πŸ”

πŸ‘‚Share your thoughts on your AFP News experience to help us improve it. Your opinion matters.

Trouver facilement le bon contenu 🎯

10 articles in this category.
Written by Thibault FERRAND and Marie Abraham.