> For the complete documentation index, see [llms.txt](https://docs.autocontentapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autocontentapi.com/quick-start/deep-researches/create-research-podcast.md).

# 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)