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"
  }
]

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

media_formats[]
enum<string>[]

The media formats to fetch data for

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.

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 milliseconds (audio or video)

avg_listen_duration
number

Average proportion of the item consumed (0.0–1.0)

published
string<date-time> | null

Time at which the content was published (ISO 8601)

media
object | null