List Podcasts by Publication URL | AISquare Studio

curl /api/v1/podcasts/by-url/ \
     -H "Content-Type: application/json"

{
  "count": 123,
  "results": [
    {
      "id": 101,
      "uid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "title": "The Future of AI in Healthcare",
      "created_at": "2024-04-10T14:00:00Z",
      "updated_at": "2024-04-12T10:15:00Z",
      "duration_display": "45 min",
      "category_name": "Technology",
      "subcategory_name": "Artificial Intelligence",
      "owner": {
        "id": 42,
        "email": "jane.doe@example.com",
        "full_name": "Jane Doe",
        "username": "janedoe",
        "is_verified": true,
        "profile_picture": "https://cdn.aisquare.com/users/profiles/janedoe.jpg"
      },
      "owner_username": "janedoe",
      "publications": "AI Insights Weekly",
      "rag_document_count": "12",
      "metrics": "{\"plays\": 15000, \"likes\": 1200, \"shares\": 300}",
      "workspace_id": 7,
      "description": "Exploring how artificial intelligence is transforming patient care and medical research.",
      "language": "en",
      "length": 45,
      "knowledge_level": "intermediate",
      "generation_status": "completed",
      "visibility": "public",
      "is_draft": false,
      "logo": "https://cdn.aisquare.com/podcasts/logos/ai_healthcare.png",
      "cover_image": "https://cdn.aisquare.com/podcasts/covers/ai_healthcare_cover.jpg"
    }
  ],
  "next": "http://api.aisquare.com/api/v1/podcasts/by-url/?page=4",
  "previous": "http://api.aisquare.com/api/v1/podcasts/by-url/?page=2"
}

This endpoint returns a paginated list of podcasts. For GET requests, it returns the base podcast list. For POST requests, if the JSON body contains a ‘url’ parameter (representing the publication’s custom URL), the view will filter the podcasts to return only those whose ‘owner’ matches the Publication owner’s user. If the ‘url’ parameter is omitted, the full list is returned.

Query parameters

categorystringOptional

created_afterdatetimeOptional

created_beforedatetimeOptional

descriptionstringOptional

focus_areastringOptional

generation_statusenumOptional

Current status of podcast generation process

not_started - Not Started
generating_script - Generating Script
script_generated - Script Generated
generating_audio - Generating Audio
completed - Completed
failed - Failed

Current status of podcast generation process * `not_started` - Not Started * `generating_script` - Generating Script * `script_generated` - Script Generated * `generating_audio` - Generating Audio * `completed` - Completed * `failed` - Failed

is_draftbooleanOptional

knowledge_levelenumOptional

Target knowledge level for the podcast audience

beginner - Beginner
intermediate - Intermediate
advanced - Advanced
expert - Expert

Target knowledge level for the podcast audience * `beginner` - Beginner * `intermediate` - Intermediate * `advanced` - Advanced * `expert` - Expert

Allowed values:

max_lengthintegerOptional

min_lengthintegerOptional

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

publicationstringOptional

subcategorystringOptional

tagsstringOptional

titlestringOptional

visibilitystringOptional

voice_typestringOptional

Response

A paginated list of podcasts. If a 'url' is provided in the POST body, only podcasts created by the corresponding Publication owner are returned.

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

Errors

400

Bad Request Error

401

Unauthorized Error