What are all of the possible routes and filters available for the content export XML feed?
Overview
The following routes and filters are possible for the NewsML Export for Articles.
Currently, there is a limit of 50 articles being returned with a single NewsML call based on routes and filters.
Routes and Filters
The below routes are all assume version 1 of the API and are for articles
https://www.domain.com/api/v1/articles/….
1. Route: Article ID(s)
Purpose:
Provide a specific article id or list of article IDs in a comma delimited list.
If a range in included, all articles included in the range will be returned along with any additional articles outside of the range, but in the comma-delimited list.
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
Example:
https://www.domain.com/api/v1/articles/68283,20958,20959,52858
https://www.domain.com/api/v1/articles/4,13-27,91
2. Route: Date Range with Data Type filters
Purpose:
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.
Example:
https://www.domain.com/api/v1/articles/from/2015-03-01/to/2016-01-01?datetype=pull_date
3. Route: Taxonomy Association
Purpose:
In a comma delimited list, put in the desired taxonomies.
NOTE: If a range of taxonomies is included, only the range will be included.
The articles contained using this route are limited to the 50 max articles returned with a single request.
Example:
4. Route: Publication/Publication Edition
Purpose:
Pull all of the articles / blog posts associated with a specific newsletter issue or publication edition.
This would not be comma delimited.
Only a single issue or edition would be returned.
Example:
https://www.domain.com/api/v1/articles/publication-edition/63
5. Route: Newsletter/Newsletter Issue
Purpose:
Pull all of the articles / blog posts associated with a specific newsletter issue or publication edition.
This would not be comma delimited.
Only a single issue or edition would be returned.
Example: