# Start Deep Research

Collect long-form insights and analysis ready for podcasts, posts, or briefing packs. This guide mirrors the AutoContent app flow so you can submit research, monitor progress, and hand the results off to other tools.

## Before You Begin

* Configure your API key under `Settings`; the research pages hide until authentication succeeds.
* Decide whether you want a one-off briefing or a recurring digest so you can set frequency up front.
* Keep in mind that each request consumes credits (Gemini: 100, OpenAI: 200) even when you run them in bulk.

## Step 1: Open the Research Composer

1. In the sidebar, choose `Deep Research -> Researches`.
2. Click `New Research` in the header to launch the composer at `/research/create`.

If you are migrating multiple prompts, you can jump straight into bulk mode using the toggle in the top-right corner of the form (details below).

## Step 2: Craft Your Prompt

In single-request mode, complete the following fields:

| Field          | Required | Description                                                                                                        |
| -------------- | -------- | ------------------------------------------------------------------------------------------------------------------ |
| Research Query | ✅        | The question or topic to investigate; add context, time frames, or desired angles for richer output.               |
| AI Provider    | ✅        | Choose between `Gemini` (default) or `OpenAI` depending on the analysis style you prefer.                          |
| Recurring      | Optional | Toggle on to run the same request automatically. Once active, set `Times per day` (1-24) and an optional end date. |

Use the prompt description beneath the text area as a checklist; the app surfaces guardrails (for example, missing prompts) before it sends the request.

## Step 3: Submit and Track

Click `New Research`. The button locks while the request is in flight and flips to a loader so you know it succeeded. Behind the scenes the app performs:

```bash
curl -X POST "https://api.autocontentapi.com/deep-research/research" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "What are the latest developments in climate tech policy?",
    "outputType": "text",
    "provider": "gemini"
  }'
```

When you enable the recurring toggle, the payload also includes `"isScheduled": true`, `"dailyCount": <1-24>`, and, if specified, an ISO-formatted `"scheduleEndDate"`.

Successful responses immediately appear inside the `Researches` list with status `0` or `5`. The app automatically refreshes in the background until each item reaches `100` (complete) or reports an error. You can always click the `Refresh` icon in the list header to force an update.

## Step 4: Review Results in Researches

Back on `/research` you get a filtered dashboard:

* Use the status tabs (`All`, `Completed`, `Processing`, `Failed`) and search bar to zero in on the right request.
* Select a research item to view its full transcript, copy the rundown as rich HTML or clean text, or retry a failed job.
* Launch `Create podcast` from a completed research to pre-fill the episode workflow described in [Create a Podcast Episode from Deep Research](/quick-start/deep-researches/create-research-podcast.md).
* Multi-select several items to send them to the bulk podcast builder, schedule them, or export transcripts.

## Step 5: Run Bulk Research (Optional)

Need dozens of summaries at once? Toggle `Switch to bulk mode` from the composer header:

1. Paste one prompt per line into the bulk textarea.
2. Pick the provider and (optionally) enable recurring just like in single mode.
3. Click `Start Bulk Research` and confirm the number of requests. The app queues each call sequentially with a 15-second pause to respect rate limits and shows a live progress counter.

Once finished, successes and failures are tallied in the confirmation banner, and all completed runs land inside the main `Researches` list for follow-up.

## Step 6: Move Results into Shows and Episodes

Deep research is most powerful when paired with audio:

* Open any completed research and choose `Create podcast` to jump into the episode builder with the research ID preloaded.
* Inside the episode form you can also pick a `Podcast Show` (created via [Create a Podcast Show](broken://pages/BT3bjKZ3SZ4Ra5TbP1Ug)) so the finished audio drops straight into the right RSS feed.

## Common API Endpoints

* `POST /deep-research/research` - Submit a new single or scheduled research job.
* `GET /deep-research/research` - List all research requests and their statuses.
* `GET /deep-research/research/{id}` - Poll a specific request if you need tighter control over refresh intervals.

## What's Next?

* Turn a finished briefing into audio with [Create a Podcast Episode from Deep Research](/quick-start/deep-researches/create-research-podcast.md).
* Sync the resulting audio to an RSS feed using [Create a Podcast Show](broken://pages/BT3bjKZ3SZ4Ra5TbP1Ug).
* Explore the `Recurring` tab under `Deep Research -> Researches` to templatise daily or weekly digests.


---

# 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/start-deep-research.md?ask=<question>
```

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.