# 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](/quick-start/deep-researches/start-deep-research.md) 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`: ```bash 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](/quick-start/tools/track-requests.md) for the shared async flow, `request_id` handling, and `callbackData` guidance. ### Example Response ```json { "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}`: ```bash curl -X GET "https://api.autocontentapi.com/deep-research/research/550e8400-e29b-41d4-a716-446655440000" \ -H "Authorization: Bearer YOUR_API_TOKEN" ``` ### While Processing ```json { "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 ```json { "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: ```bash 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 ```json { "request_id": "research-podcast-550e8400-e29b-41d4-a716-446655440001", "status": 0 } ``` ## Step 4: Poll Podcast Status Check the podcast generation progress: ```bash curl -X GET "https://api.autocontentapi.com/content/Status/research-podcast-550e8400-e29b-41d4-a716-446655440001" \ -H "Authorization: Bearer YOUR_API_TOKEN" ``` ### While Processing ```json { "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: ```json { "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 ```bash curl -X GET "https://api.autocontentapi.com/deep-research/research" \ -H "Authorization: Bearer YOUR_API_TOKEN" ``` ### Get Specific Research Details ```bash 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: ```bash 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 ```json { "text": "What are the breakthrough innovations in quantum computing and their practical applications?", "outputType": "text", "provider": "gemini" } ``` ### Business & Economics ```json { "text": "How is artificial intelligence transforming the financial services industry in 2024?", "outputType": "text", "provider": "openai" } ``` ### Science & Health ```json { "text": "What are the latest developments in personalized medicine and gene therapy?", "outputType": "text", "provider": "gemini" } ``` ### Market Analysis ```json { "text": "What are the emerging trends in renewable energy technology and market adoption?", "outputType": "text", "provider": "gemini" } ``` ## Error Handling ### Research Request Errors ```json { "success": false, "error": "Invalid research query provided" } ``` ### Research Failed ```json { "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 ```json { "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](/quick-start/podcasts/create-podcast-episode.md) from web resources * 🐦 Explore [Creating Podcasts from X Feeds](/quick-start/podcasts/create-feed-podcast.md) * 📖 Check out more [Code Samples](/code-samples.md) in different languages * 🗣️ Discover [Custom Voices](/voices.md) for personalized research podcasts * ❓ Have questions? Visit our [FAQ](/faq.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.autocontentapi.com/quick-start/deep-researches/create-research-podcast.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.