Create a Podcast Episode from Deep Research

Learn how to perform advanced research on any topic and use the results to generate comprehensive AI-powered podcast episodes.

Need help generating research IDs from the app? Follow Start Deep Research to create and manage your deep research requests before you continue here.

Step 1: Create Deep Research Request

Start by creating a deep research request using /deep-research/research:

curl -X POST "https://api.autocontentapi.com/deep-research/research" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "What are the latest developments in artificial intelligence and machine learning in 2024?",
    "outputType": "text",
    "provider": "gemini",
    "callbackData": "ai-research-2024"
  }'

Request Parameters

Parameter	Description	Required	Options
text	The research query	Yes	Any research question
outputType	Format of results	Yes	"text"
provider	AI provider to use	No	"gemini", "openai" (default: "gemini")
callbackData	Optional callback data	No	Any string

Use Track Requests & Status Codes for the shared async flow, request_id handling, and callbackData guidance.

Example Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Important: Save the request_id - you'll need it to check research status and create your podcast!

Step 2: Poll Research Status

Check the research progress using /deep-research/research/{id}:

curl -X GET "https://api.autocontentapi.com/deep-research/research/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

While Processing

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "requestedOn": "2024-01-15T10:30:00Z",
  "status": 5,
  "errorOn": null,
  "errorMessage": null,
  "errorCode": 0,
  "prompt": "What are the latest developments in artificial intelligence and machine learning in 2024?"
}

Research Completed

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "requestedOn": "2024-01-15T10:30:00Z",
  "succeededOn": "2024-01-15T10:35:00Z",
  "status": 100,
  "errorOn": null,
  "errorMessage": null,
  "errorCode": 0,
  "prompt": "What are the latest developments in artificial intelligence and machine learning in 2024?",
  "responseText": "Based on extensive research, here are the key developments in AI and ML for 2024..."
}

Research Status Codes:

• 0 = Pending (queued for research)

• 5 = Processing (research in progress)

• 100 = Completed (research ready!)

Step 3: Create Podcast from Research

Once research status is 100, use the research ID to create a podcast:

curl -X POST "https://api.autocontentapi.com/content/Create" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "researches": ["550e8400-e29b-41d4-a716-446655440000"],
    "outputType": "audio",
    "text": "Create an engaging podcast discussion based on this comprehensive research about AI developments",
    "duration": "long"
  }'

Example Response

{
  "request_id": "research-podcast-550e8400-e29b-41d4-a716-446655440001",
  "status": 0
}

Step 4: Poll Podcast Status

Check the podcast generation progress:

curl -X GET "https://api.autocontentapi.com/content/Status/research-podcast-550e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

While Processing

{
  "id": "research-podcast-550e8400-e29b-41d4-a716-446655440001",
  "status": 5,
  "updated_on": "2024-01-15T10:40:00Z",
  "error_code": 0,
  "requested_on": "2024-01-15T10:38:00Z"
}

Step 5: Get Your Research-Based Podcast

When status reaches 100, your comprehensive podcast is ready:

{
  "id": "research-podcast-550e8400-e29b-41d4-a716-446655440001",
  "audio_title": "Deep Dive: AI and ML Developments in 2024",
  "status": 100,
  "audio_url": "https://storage.autocontentapi.com/audio/research-podcast-550e8400-e29b-41d4-a716-446655440001.mp3",
  "response_text": "Full transcript of the comprehensive discussion based on deep research findings...",
  "requested_on": "2024-01-15T10:38:00Z",
  "updated_on": "2024-01-15T10:45:00Z",
  "request_type_id": 1,
  "error_code": 0,
  "file_size": 25234567,
  "audio_duration": 1234.56,
  "share_url": "https://autocontentapi.com/share/research-podcast-550e8400-e29b-41d4-a716-446655440001"
}

🎉 Success! Your research-based podcast is ready with comprehensive, well-researched content!

Managing Your Research

List All Your Research Requests

curl -X GET "https://api.autocontentapi.com/deep-research/research" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Get Specific Research Details

curl -X GET "https://api.autocontentapi.com/deep-research/research/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Advanced: Multiple Research Sources

You can combine multiple research results in a single podcast:

curl -X POST "https://api.autocontentapi.com/content/Create" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "researches": [
      "550e8400-e29b-41d4-a716-446655440000",
      "550e8400-e29b-41d4-a716-446655440001",
      "550e8400-e29b-41d4-a716-446655440002"
    ],
    "outputType": "audio",
    "text": "Create a comprehensive podcast combining insights from all these research findings",
    "duration": "long"
  }'

Note: Maximum of 10 research IDs per request.

Research Query Ideas

Technology Research

{
  "text": "What are the breakthrough innovations in quantum computing and their practical applications?",
  "outputType": "text",
  "provider": "gemini"
}

Business & Economics

{
  "text": "How is artificial intelligence transforming the financial services industry in 2024?",
  "outputType": "text",
  "provider": "openai"
}

Science & Health

{
  "text": "What are the latest developments in personalized medicine and gene therapy?",
  "outputType": "text",
  "provider": "gemini"
}

Market Analysis

{
  "text": "What are the emerging trends in renewable energy technology and market adoption?",
  "outputType": "text",
  "provider": "gemini"
}

Error Handling

Research Request Errors

{
  "success": false,
  "error": "Invalid research query provided"
}

Research Failed

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": 0,
  "errorOn": "2024-01-15T10:32:00Z",
  "errorMessage": "Research query too broad, please be more specific",
  "errorCode": 400
}

Podcast Creation with Invalid Research ID

{
  "error": "Research ID not found or not accessible",
  "status": 400
}

Benefits of Research-Based Podcasts

Comprehensive Coverage: Deep research provides thorough analysis of complex topics

Current Information: Research pulls from the latest available sources and data

Multiple Perspectives: Research synthesizes information from various authoritative sources

Fact-Checked Content: Research process includes verification and cross-referencing

Professional Quality: Research-based podcasts sound more authoritative and well-informed

Use Cases

Educational Content: Create in-depth educational podcasts on complex subjects

Industry Reports: Generate comprehensive industry analysis and trend reports

Investment Research: Create detailed market analysis and investment insights

Academic Discussions: Transform complex research topics into accessible audio content

Expert Interviews Prep: Use research as background for preparing interview questions

Research Tips

1. Be Specific: More focused queries yield better research results

2. Use Keywords: Include relevant industry terms and specific concepts

3. Time-Sensitive Topics: Specify time ranges for current information

4. Multiple Angles: Create separate research requests for different aspects of complex topics

5. Provider Selection: Try both Gemini and OpenAI to see which works better for your topic

What's Next?

• 🎧 Learn about Creating Basic Podcasts from web resources

• 🐦 Explore Creating Podcasts from X Feeds

• 📖 Check out more Code Samples in different languages

• 🗣️ Discover Custom Voices for personalized research podcasts

• ❓ Have questions? Visit our FAQ