Skip to main content
GET
/
projects
/
{project_id}
/
content
/
analytics
Contents analytics
curl --request GET \
  --url https://api.beyondwords.io/v1/projects/{project_id}/content/analytics \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": "b48ddb68-9a70-4443-9990-4f0479095f77,",
    "source_id": 12345,
    "title": "Project title",
    "listens": 29103,
    "avg_listen_time": 243,
    "avg_listen_duration": 86.52,
    "published": "2022-12-31 23:59:59 UTC"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.beyondwords.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
project_id
string
required

The numeric ID of your project

Query Parameters

​
media_variants[]
enum<string>[]

The media variants to fetch data for

Available options:
article,
summary
​
media_formats[]
enum<string>[]

The media formats to fetch data for

Available options:
audio,
video
​
time_range[start]
string

The start date of the aggregation period. The value of this property should be a string in the format yyyy-mm-dd according to ISO 8601.

​
time_range[end]
string

The end date of the aggregation period. The value of this property should be a string in the format yyyy-mm-dd according to ISO 8601. If this is set to today, the current day is still in progress and therefore only partial analytics data is returned until the day ends.

​
pagination[limit]
integer

'limit' sets the number of results to return in each page.

​
pagination[offset]
integer

'offset' sets the first position to return from the results of the query. The default is 0, which starts the page at the first result.

​
order[by]
enum<string>

This is used to order analytics by number of listens or average listen time or average listen duration

Available options:
player_impressions,
listens,
listen_rate,
avg_listen_time,
avg_listen_duration
​
order[dir]
enum<string>

This is used to order analytics in the ascending or descending order

Available options:
asc,
desc
​
filter[title]
string

Get analytics for content whose title contains the specified string. Note: filter[title] does not work in combination with order[by]

​
filter[player_impressions][to]
integer
​
filter[player_impressions][from]
integer
​
filter[listens][to]
integer
​
filter[listens][from]
integer
​
filter[listen_rate][to]
integer
​
filter[listen_rate][from]
integer
​
filter[avg_listen_time][to]
integer
​
filter[avg_listen_time][from]
integer
​
filter[avg_listen_duration][to]
integer
​
filter[avg_listen_duration][from]
integer

Response

200 - application/json

OK

​
id
string | null

Content identifier

​
source_id
string

Externally provided content identifier

​
source_url
string<uri> | null

URL of the source content

​
image_url
string<uri> | null

Content image URL

​
title
string | null

Content title

​
player_impressions
integer

Number of player loads (audio or video)

​
listens
integer

Number of play sessions (audio or video)

​
listen_rate
number

Proportion of impressions that resulted in a play (0.0–1.0)

​
avg_listen_time
integer

Average play time per session in seconds (audio or video). This metric may be understated when play progress is stored as every 10% milestone event per session instead of only a final event.

​
avg_listen_duration
number

Average percentage of the item consumed (0-100). This metric may be understated when play progress is stored as every 10% milestone event per session instead of only a final event.

​
published
string<date-time> | null

Time at which the content was published (ISO 8601)

​
media
object