GET Top Podcasts
Overview
The following table contains important information about the GET method in regards to receiving the top podcasts for the platform.
| GET Top Podcasts | |
|---|---|
| Method | GET |
| URL or Endpoint | /api/v1/projects/projectId/dashboard/topPodcasts |
| Headers | Authorization |
| Parameters | projectId, startDate, endDate, items, intervalType |
| Body | Not Applicable |
The description of the URL parameter is as follows:
| projectId URL Parameter | |
|---|---|
| URL Parameter Name | projectId |
| Mandatory | Yes |
| Type | string |
| Description | Unique Id of the project |
The description of the query parameters is as follows:
| Parameter Name | Mandatory | Type | Description |
|---|---|---|---|
| intervalType | No | integer($int32) | Determines the time interval for which the top podcasts are calculated. Available values: 0, 1, 2, 3, 4, 5, 6, 7, 8 |
| startDate | No | string($date-time) | The start date and time from which to begin collecting podcast data. |
| endDate | No | string($date-time) | The end date and time up to which to collect podcast data. |
| items | No | integer($int32) | The number of top podcasts to return. |
If no intervalType value is provided, the endpoint defaults to returning the top videos for the last 24 hours.
To manually specify startDate and endDate, the intervalType parameter must be set to 5. Otherwise, any provided dates will be ignored.
Request Body
The request does not contain a request body.
Response
{
"success": true,
"errors": [
"string"
],
"messages": [
"string"
],
"result": [
{
"id": "string",
"thumbnailUrl": "string",
"canEmbed": true,
"title": "string",
"author": "string",
"insertDate": "2025-10-29T13:35:14.117Z",
"listens": 0
}
],
"resultInfo": "string",
"statusCode": 200
}
Information about the fields that appear when you receive the response are displayed in the table below.
| Field Name | Type | Description |
|---|---|---|
| success | bool | If the response is successful it will return true. Otherwise will return false. |
| errors | array[string] | Indicates if there was an error. |
| messages | array[string] | Returns the response message from back-end. |
| result | array[object] | Returns the list of top podcasts along with their metadata and play counts. |
| id | string | Unique identifier of the podcast. |
| thumbnailUrl | string | URL of the podcast's thumbnail image. |
| canEmbed | bool | Specifies whether the podcast can be embedded on external sites. |
| title | string | The title of the podcast. |
| author | string | The name of the podcast's creator or publisher. |
| insertDate | string($date-time) | The date and time when the podcast was uploaded or recorded. |
| listens | integer($int32) | The total number of listeners for the podcast within the specified interval. |
| resultInfo | string | Returns extra information about the result. |
| statusCode | integer($int32) | Returns the HTTP Status Code. |
If the action is successful, the service sends back an HTTP 200 or 201 response.
Errors
For information about the errors that are common to all actions, see Common Errors:
HTTP Status Code 400: Bad Request
HTTP Status Code 401: Unauthorized
HTTP Status Code 403: Forbidden
HTTP Status Code 404: Result Not Found
HTTP Status Code 500: Internal Server Error
HTTP Status Code 503: Backend Fetch Failed