Deep Research

Advanced research operations

Get all deep research requests

get

Retrieves all deep research requests made by the authenticated user

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
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

Last updated