Skip to main content

How to Get Publishing Statistics from the Arc XP APIs

Summary

Both Content API and WebSked API are able to provide publishing statistics. 

WebSked and Content API use different data stores and count publishes differently, as a result queries to each API for similar data may provide slightly different results. Refer to WebSked and Content API documentation for more information.

Procedure

Content API

Content API is able to return story counts using the /scan endpoint. The /scan endpoint will accept any Elastic Search (ES) query and will return a count of matching documents.

Example scanning for stories with a range of dates:

GET https://api.{org}.arcpublishing.com/content/v4/scan?website={website_name}&q=type:story+AND+publish_date:[YYYY-MM-DD+TO+YYYY-MM-DD]+AND+canonical_website:{website_name}&_sourceInclude=publish_date,headlines.basic&size=5

WebSked API

WebSked API is able to return story counts and other publishing and pitch statistics relevant to WebSked.

For example, the following call will return a story count for a time range.  The WebSked API received time inputs in epoch time.

https://api.{org}.arcpublishing.com/websked/stats/storyCount?startTime=[time in epoch]&endTime=[time in epoch]&interval=day&offset=%2B1h

More Information