Getting started
Content
- Articles
- Pronunciation rules
- Summarization settings
- Video settings
Distribution
- Player
- Playlists
Analytics
- Analytics
Monetization
- Ads
Organization
- Projects
List content
Lists content within a project
curl --request GET \
--url https://api.beyondwords.io/v1/projects/{project_id}/content \
--header 'X-Api-Key: <api-key>'
[
{
"id": "d7dfd636-098c-4b1b-83e5-15a3cba5a0bd",
"status": "processed",
"type": "auto_segment",
"title": "<h1 data-beyondwords-marker=\"h1-title\">Example title</h1>",
"summary": "<h2 data-beyondwords-marker=\"h2-summary\">This article is about TTS</h2>",
"body": "<p data-beyondwords-marker=\"paragraph-1\">Example body</p>",
"source_id": "example-source-id",
"source_url": "https://example.com/some-article",
"author": "John Smith",
"image_url": "https://example.com/image.jpeg",
"title_enabled": true,
"body_enabled": true,
"summary_enabled": true,
"metadata": {
"key": "value"
},
"audio": [
{
"id": 1,
"content_type": "application/vnd.apple.mpegurl",
"url": "https://example.com/audio.m3u8",
"duration": 10000
},
{
"id": 2,
"content_type": "audio/mpeg,",
"url": "https://example.com/audio.mp3",
"duration": 10000
}
],
"video": [
{
"id": 1,
"content_type": "video/mp4",
"url": "https://example.com/waveform-video.mp4",
"duration": 10000
}
],
"segments": [
{
"id": 1,
"section": "title",
"marker": "h1-title",
"xpath": "/html/body/h1",
"md5": "0cc175b9c0f1b6a831c399e269772661",
"content_type": "text",
"text": "Example title",
"audio_url": null,
"image_url": null,
"language": {
"code": "en_GB",
"name": "English"
},
"voice": {
"id": 123,
"name": "Jane"
},
"preprocessing_settings": {
"ai_preprocessing_enabled": true
},
"start_time": 3,
"duration": 2000,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
},
{
"id": 2,
"section": "summary",
"marker": "h2-summary",
"xpath": "/html/body/h2",
"md5": "0cc175b9c0f1b6a831c399e269772661",
"content_type": "text",
"text": "This article is about text-to-speech",
"audio_url": null,
"image_url": null,
"language": {
"code": "en_GB",
"name": "English"
},
"voice": {
"id": 123,
"name": "Jane"
},
"preprocessing_settings": null,
"start_time": 2006,
"duration": 6000,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
},
{
"id": 3,
"section": "body",
"marker": "paragraph-1",
"xpath": "/html/body/p[1]",
"md5": "0cc175b9c0f1b6a831c399e269772661",
"content_type": "text",
"text": "Example title",
"audio_url": null,
"image_url": null,
"language": {
"code": "en_GB",
"name": "English"
},
"voice": {
"id": 123,
"name": "Jane"
},
"preprocessing_settings": null,
"start_time": 8009,
"duration": 1991,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
}
],
"ads_enabled": true,
"auto_segment_updates_enabled": true,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
},
{
"id": "d7dfd636-098c-4b1b-83e5-15a3cba5a0bd",
"status": "processed",
"type": "manual_segment",
"source_id": "example-source-id-1",
"source_url": "https://example.com/some-article",
"author": "John Smith",
"image_url": "https://example.com/image.jpeg",
"metadata": {
"key": "value"
},
"audio": [
{
"id": 1,
"content_type": "application/vnd.apple.mpegurl",
"url": "https://example.com/audio.m3u8",
"duration": 10000
},
{
"id": 2,
"content_type": "audio/mpeg,",
"url": "https://example.com/audio.mp3",
"duration": 10000
}
],
"video": [
{
"id": 1,
"content_type": "video/mp4",
"url": "https://example.com/waveform-video.mp4",
"duration": 10000
}
],
"segments": [
{
"id": 1,
"section": "title",
"content_type": "text",
"text": "This is a title",
"voice": {
"id": 1
},
"preprocessing_settings": {
"ai_preprocessing_enabled": true
}
},
{
"id": 2,
"section": "body",
"content_type": "text",
"text": "This is new paragraph",
"voice": {
"id": 1
},
"preprocessing_settings": null
},
{
"id": 3,
"section": "body",
"content_type": "image",
"image_url": "https://example.com/image.jpeg",
"preprocessing_settings": null
},
{
"id": 4,
"section": "body",
"content_type": "text",
"text": "This is another paragraph",
"voice": {
"id": 1
},
"preprocessing_settings": null
},
{
"id": 5,
"section": "body",
"content_type": "audio",
"audio_url": "https://example.com/image.mp3",
"preprocessing_settings": null
},
{
"id": 6,
"section": "body",
"content_type": "text",
"text": "This is another paragraph",
"voice": {
"id": 1
},
"preprocessing_settings": null,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
}
],
"ads_enabled": true,
"auto_segment_updates_enabled": true,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
}
]
Authorizations
Path Parameters
The numeric ID of your project
Query Parameters
The level of detail to show for segments in the response: 'none', 'partial' or 'full'
partial
, full
filter by content id
filter by content source id
filter by content source url
filter by content title
filter by content body
filter by content published status
filter by content statuses
filter by created time from (ISO 8601)
filter by created time to (ISO 8601)
filter by updated time from (ISO 8601)
filter by updated time to (ISO 8601)
filter by publish date from (ISO 8601)
filter by publish date to (ISO 8601)
'limit' sets the number of results to return in each page.
'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.
This is used to order content
created
, publish_date
, duration
, published
, status
This is used to order analytics in the ascending or descending order
asc
, desc
Response
The response is of type object[]
.
Was this page helpful?
curl --request GET \
--url https://api.beyondwords.io/v1/projects/{project_id}/content \
--header 'X-Api-Key: <api-key>'
[
{
"id": "d7dfd636-098c-4b1b-83e5-15a3cba5a0bd",
"status": "processed",
"type": "auto_segment",
"title": "<h1 data-beyondwords-marker=\"h1-title\">Example title</h1>",
"summary": "<h2 data-beyondwords-marker=\"h2-summary\">This article is about TTS</h2>",
"body": "<p data-beyondwords-marker=\"paragraph-1\">Example body</p>",
"source_id": "example-source-id",
"source_url": "https://example.com/some-article",
"author": "John Smith",
"image_url": "https://example.com/image.jpeg",
"title_enabled": true,
"body_enabled": true,
"summary_enabled": true,
"metadata": {
"key": "value"
},
"audio": [
{
"id": 1,
"content_type": "application/vnd.apple.mpegurl",
"url": "https://example.com/audio.m3u8",
"duration": 10000
},
{
"id": 2,
"content_type": "audio/mpeg,",
"url": "https://example.com/audio.mp3",
"duration": 10000
}
],
"video": [
{
"id": 1,
"content_type": "video/mp4",
"url": "https://example.com/waveform-video.mp4",
"duration": 10000
}
],
"segments": [
{
"id": 1,
"section": "title",
"marker": "h1-title",
"xpath": "/html/body/h1",
"md5": "0cc175b9c0f1b6a831c399e269772661",
"content_type": "text",
"text": "Example title",
"audio_url": null,
"image_url": null,
"language": {
"code": "en_GB",
"name": "English"
},
"voice": {
"id": 123,
"name": "Jane"
},
"preprocessing_settings": {
"ai_preprocessing_enabled": true
},
"start_time": 3,
"duration": 2000,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
},
{
"id": 2,
"section": "summary",
"marker": "h2-summary",
"xpath": "/html/body/h2",
"md5": "0cc175b9c0f1b6a831c399e269772661",
"content_type": "text",
"text": "This article is about text-to-speech",
"audio_url": null,
"image_url": null,
"language": {
"code": "en_GB",
"name": "English"
},
"voice": {
"id": 123,
"name": "Jane"
},
"preprocessing_settings": null,
"start_time": 2006,
"duration": 6000,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
},
{
"id": 3,
"section": "body",
"marker": "paragraph-1",
"xpath": "/html/body/p[1]",
"md5": "0cc175b9c0f1b6a831c399e269772661",
"content_type": "text",
"text": "Example title",
"audio_url": null,
"image_url": null,
"language": {
"code": "en_GB",
"name": "English"
},
"voice": {
"id": 123,
"name": "Jane"
},
"preprocessing_settings": null,
"start_time": 8009,
"duration": 1991,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
}
],
"ads_enabled": true,
"auto_segment_updates_enabled": true,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
},
{
"id": "d7dfd636-098c-4b1b-83e5-15a3cba5a0bd",
"status": "processed",
"type": "manual_segment",
"source_id": "example-source-id-1",
"source_url": "https://example.com/some-article",
"author": "John Smith",
"image_url": "https://example.com/image.jpeg",
"metadata": {
"key": "value"
},
"audio": [
{
"id": 1,
"content_type": "application/vnd.apple.mpegurl",
"url": "https://example.com/audio.m3u8",
"duration": 10000
},
{
"id": 2,
"content_type": "audio/mpeg,",
"url": "https://example.com/audio.mp3",
"duration": 10000
}
],
"video": [
{
"id": 1,
"content_type": "video/mp4",
"url": "https://example.com/waveform-video.mp4",
"duration": 10000
}
],
"segments": [
{
"id": 1,
"section": "title",
"content_type": "text",
"text": "This is a title",
"voice": {
"id": 1
},
"preprocessing_settings": {
"ai_preprocessing_enabled": true
}
},
{
"id": 2,
"section": "body",
"content_type": "text",
"text": "This is new paragraph",
"voice": {
"id": 1
},
"preprocessing_settings": null
},
{
"id": 3,
"section": "body",
"content_type": "image",
"image_url": "https://example.com/image.jpeg",
"preprocessing_settings": null
},
{
"id": 4,
"section": "body",
"content_type": "text",
"text": "This is another paragraph",
"voice": {
"id": 1
},
"preprocessing_settings": null
},
{
"id": 5,
"section": "body",
"content_type": "audio",
"audio_url": "https://example.com/image.mp3",
"preprocessing_settings": null
},
{
"id": 6,
"section": "body",
"content_type": "text",
"text": "This is another paragraph",
"voice": {
"id": 1
},
"preprocessing_settings": null,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
}
],
"ads_enabled": true,
"auto_segment_updates_enabled": true,
"created": "2023-01-01 00:00:00 UTC",
"updated": "2023-01-01 00:00:05 UTC"
}
]