Deep Research

Advanced research operations

Get all deep research requests

get

Retrieves all deep research requests made by the authenticated user

Authorizations
Responses
200

Successfully retrieved deep research requests

application/json
get
/deep-research/research
GET /deep-research/research HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

Successfully retrieved deep research requests

[
  {
    "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?",
    "outputType": "json",
    "jsonFormat": "{\"summary\":\"\",\"keyInsights\":[]}",
    "isScheduleTemplate": true,
    "scheduleId": "550e8400-e29b-41d4-a716-446655440000",
    "dailyCount": 2,
    "scheduleEndDate": "2024-12-31T23:59:59Z",
    "lastScheduleExecutionOn": "2024-01-16T09:00:00Z",
    "nextScheduleExecutionOn": "2024-01-16T12:00:00Z"
  }
]

Perform deep research on a given query

post

Conducts advanced research on the provided text query and returns results in the specified output format

Authorizations
Body
textstringRequired

The research query text

Example: What are the latest developments in artificial intelligence?
outputTypestring · enumRequired

The format of the output result. When set to json, the response is serialized JSON.

Example: jsonPossible values:
jsonFormatstringOptional

Optional instructions or template describing the JSON structure to generate.

Example: { "summary": "", "keyFindings": [], "sources": [] }
providerstring · enumOptional

The AI provider to use for research (defaults to gemini)

Example: geminiPossible values:
projectIdsstring[]Optional

Optional array of project IDs to add context from their descriptions

Example: ["proj-123","proj-456"]
callbackDatastringOptional

Optional callback data to be returned with the response

Example: user-specific-data
isScheduledbooleanOptional

If true, creates a recurring schedule instead of a one-time request

Example: false
dailyCountinteger · min: 1 · max: 24Optional

Number of times per day to execute the research (default 1, only used when isScheduled is true)

Example: 2
scheduleEndDatestring · date-timeOptional

Optional end date for the schedule (only used when isScheduled is true). If not provided, schedule runs indefinitely.

Example: 2024-12-31T23:59:59Z
Responses
200

Research request or schedule submitted successfully

application/json
Responseone of
or
post
/deep-research/research
POST /deep-research/research HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 347

{
  "text": "What are the latest developments in artificial intelligence?",
  "outputType": "json",
  "jsonFormat": "{\n  \"summary\": \"\",\n  \"keyFindings\": [],\n  \"sources\": []\n}\n",
  "provider": "gemini",
  "projectIds": [
    "proj-123",
    "proj-456"
  ],
  "callbackData": "user-specific-data",
  "isScheduled": false,
  "dailyCount": 2,
  "scheduleEndDate": "2024-12-31T23:59:59Z"
}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Get a specific deep research request by ID

get

Retrieves a single deep research request by its unique ID

Authorizations
Path parameters
idstringRequired

The ID of the deep research request to retrieve

Responses
200

Successfully retrieved deep research request

application/json
get
/deep-research/research/{id}
GET /deep-research/research/{id} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "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?",
  "outputType": "json",
  "jsonFormat": "{\"summary\":\"\",\"keyInsights\":[]}",
  "isScheduleTemplate": true,
  "scheduleId": "550e8400-e29b-41d4-a716-446655440000",
  "dailyCount": 2,
  "scheduleEndDate": "2024-12-31T23:59:59Z",
  "lastScheduleExecutionOn": "2024-01-16T09:00:00Z",
  "nextScheduleExecutionOn": "2024-01-16T12:00:00Z",
  "responseText": "{\"summary\":\"AI advancements\",\"keyInsights\":[\"...\"]}"
}

Get recurring deep research templates

get

Returns all recurring deep research templates for the authenticated user with their configuration and scheduling details.

Authorizations
Responses
200

Successfully retrieved recurring templates

application/json
get
/deep-research/recurring
GET /deep-research/recurring HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "templates": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "text": "Latest developments in quantum computing",
      "provider": "gemini",
      "outputType": "json",
      "jsonFormat": "{\"summary\":\"\",\"takeaways\":[]}",
      "deletedOn": null,
      "callbackData": "user-data-123",
      "dailyCount": 2,
      "scheduleEndDate": "2024-12-31T23:59:59Z",
      "lastRunAt": "2024-01-15T10:30:00Z",
      "nextRunAt": "2024-01-15T14:30:00Z",
      "createdOn": "2024-01-01T00:00:00Z"
    }
  ]
}

Update a recurring deep research template

post

Updates specific fields of a recurring template. Can be used to pause/resume, change frequency, update end date, or modify the research text.

Authorizations
Path parameters
idstringRequired

The unique ID of the recurring template to update

Example: 550e8400-e29b-41d4-a716-446655440000
Body
textstringOptional

New research query text

Example: Updated research on AI ethics
dailyCountinteger · min: 1 · max: 24Optional

New number of executions per day

Example: 3
scheduleEndDatestring · date-time | nullableOptional

New end date for the recurring executions (null to remove end date)

Example: 2025-01-31T23:59:59Z
isActivebooleanOptional

Set to false to pause the recurring template, true to resume

Example: false
Responses
200

Recurring template updated successfully

application/json
post
/deep-research/recurring/{id}
POST /deep-research/recurring/{id} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "text": "Updated research on AI ethics",
  "dailyCount": 3,
  "scheduleEndDate": "2025-01-31T23:59:59Z",
  "isActive": false
}
{
  "success": true,
  "message": "Recurring template updated successfully",
  "template": {}
}
PreviousFeedsNextX