🔬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.
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
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
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
Be Specific: More focused queries yield better research results
Use Keywords: Include relevant industry terms and specific concepts
Time-Sensitive Topics: Specify time ranges for current information
Multiple Angles: Create separate research requests for different aspects of complex topics
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
Last updated