ePublishing Knowledge BaseePublishing Knowledge Base Content Import / ExportHow do I export XML-Feed content for articles and blog posts?

How do I export XML-Feed content for articles and blog posts?

If you want to export your articles and blog posts to an XML feed based on the NewsML-G2 standard, follow the instructions below.

There are currently the following options for different routes and filters:

  • Article ID numbers in a comma-delimited string
  • Article ID numbers in a range
  • Date range with date type filter
  • Taxonomy associations
  • By Individual Publication Edition
  • By Individual Newsletter Issue

Export XML URL:

The route for all article XML exports:

https://www.domain.com/api/v1/articles/

Based on Article ID numbers:

You can specify specific articles using the following syntax:

https://www.domain.com/api/v1/articles/68283,20958,20959,52858

The articles will be exported in the same order noted in the comma-delimited list.

The article IDs can be found in the Article Manager > Search form in the column to the far left.

Articles can be exported regardless of their state: published or unpublished or in workflow, if applicable.

Based on Article ID ranges:

You may also designate a range of article ID numbers, rather than individual ID numbers.

If a range in included, all articles included in the range will be returned along with any additional articles outside of the range as designated by the individual numbers separated by a comma:

https://www.domain.com/api/v1/articles/4,13-27,91

Based on date ranges:

Specify a date range using the following syntax:

https://www.domain.com/api/v1/articles/from/2015-03-01/to/2016-01-01?datetype=pull_date

Variables

  • from: Accepted date format YYYY-MM-DD
  • to: Accepted date format YYYY-MM-DD
  • datetype: The date field to be use to retrieve articles within the from and to range

If no datetype is set, the default post_date will be used.

Options for datetype include:

  • post_date
  • pull_date
  • updated_date - Date the article was last updated by any user
  • created_date - Date the article was created

Find the Post Date (Go Live Date) and the Pull Date in your article in the Article Manager under General.

Based on date ranges:

Find the updated_date within the Article Manager under History. The updated_date is the most recent at the top of the history.

Find the created_date under Search in the Article Manager.

Based on taxonomy association:

Specify range of taxonomy ID numbers using the following syntax, with commas separating each number (no space):

https://www.domain.com/api/v1/articles/taxonomy/42,235,654

The articles within the specified taxonomies are limited to the 50 max articles returned with a single request.

If you'd like to include a range, use the following syntax, with a hyphen designating the range (shown in the following example):

https://www.domain.com/api/v1/articles/taxonomy/42-45,235,654

To find the taxonomy ID, go to the Taxonomy Manager and click on the taxonomy you'd like to include. The ID number is circled below.

Based on Individual Newsletter Issue:

This would pull all articles and blog posts associated with a specific newsletter issue.

This is not comma-delimited; only one number will be associated with this, representing the single issue. Only content from a single issue or edition would be returned.

https://www.domain.com/api/v1/articles/newsletter-issue/5

To view the ID number of a publication and edition, go to that page on your website, and view the number in the URL:

To view the ID number of a publication and edition, go to that page on your website, and view the number in the URL:

Based on Individual Publication Edition:

This would pull all articles and blog posts associated with a specific publication edition.

This is not comma-delimited; only one number will be associated with this, representing the single issue.

Only content from a single issue or edition would be returned.

https://www.domain.com/api/v1/articles/publication-edition/42

To view the ID number of a publication and edition, go to that page on your website, and view the number in the URL:

To view the ID number of a publication and edition, go to that page on your website, and view the number in the URL: