Technical questions Regarding News API Integration

yaku_sou

I would appreciate your confirmation and clarification on the following technical points regarding the News API integration.

Question 1: Handling Deleted News Articles via API

When previously distributed news articles are later deleted or withdrawn, how is this reflected in the API?

According to the News user guide, articles that have been deleted or withdrawn will have the pubStatus field set accordingly:

• stat:withdrawn: Withdrawn by the content provider
• stat:canceled: Canceled

If pubStatus is set to stat:canceled, users—such as companies acting as authorized redistributors of Reuters news—are strictly required to remove all versions of the item from websites, caches, and other platforms.

If pubStatus is set to stat:withdrawn, the item may still be unpublished by the provider.

Conclusion (please confirm):

• If the status is canceled, the data source cannot be retrieved via the API again, and users—such as companies acting as authorized redistributors of Reuters news— are required to delete the data from their website.
• If the status is withdrawn, the data may still be accessible via the API, depending on the provider’s decision.

Could you please confirm whether this understanding is correct?

Question 2: About PNAC

Are there cases where PNAC includes characters other than A–Z / a–z / 0–9 (e.g., hyphens, underscores, dots, colons, slashes, symbols, non-ASCII characters)? If so, could you please provide the full set of allowed characters?

Additionally, as background to this question, I would like to confirm whether the following four elements can always be extracted when splitting a storyId using the delimiter :

• URN scheme
• creation_date
• PNAC
• version

Question 3: About Headlines

In the response from /data/news/v1/stories/{storyId}, the field newsItem.itemMeta.title is defined as an array. Are there cases where the number of elements exceeds one?

If multiple elements exist:

• What use cases are envisioned?
• Which element should be referenced to determine the article title?
• Are there any selection criteria or prioritization rules we should follow?

Jirapongse

@yaku_sou

Thank you for reaching out to us.

For the first question, I assumed you are referring to the NEWS SERVICE
REFINITIV DATA PLATFORM - USER GUIDE. The following is a description of the pubStatus field.

The API allows the application to send a request and receive a response, with the pubStatus included in the response message. As a result, the application can access the pubStatus directly from the response. For guidance on how to interpret or process the pubStatus property, please contact the News Service – Delivery Platform support team via LSEG Support.

For the second question, I couldn't find the document for the allowable characters for PNAC. You may need to contact the news support team directly for more information. Regarding the format of the storyID, I found this information in the news guide.

PNAC could be used to create Story ID with the following format: urn:newsml:reuters.com:{creation_date}:{PNAC}.


For example: urn:newsml:reuters.com:20180227:nNRA6cw73t:1.

The last digit could be a version number but please contact the news support team to confirm it.

For the third question, the following is the description of title.

Yes, it is an array. Please contact the News Service – Delivery Platform support team how to use it.

For me, these are not the technical API questions. They are content questions which should be answered by the News Service – Delivery Platform support team.