๐Ÿ”Ž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:

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.

  • 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) 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?

Last updated