メインコンテンツへスキップ
POST
Create tasks in bulk

承認

Authorization
string
header
必須

Your API key, sent as Authorization: Bearer <key>.

ボディ

application/json
Required array length: 1 - 500 elements
taskType
enum<string>
必須

Public task types accepted by POST /v1/async/task and its batch endpoints. Dedicated analysis endpoints and AI Rendering publication create readable tasks through their own routes.

利用可能なオプション:
CHATGPT,
PERPLEXITY,
GEMINI,
AIMODE,
GOOGLE_AIMODE,
GOOGLE,
GOOGLE_AIO,
GOOGLE_SERP,
GOOGLE_PLACES,
GOOGLE_NEWS,
NAVER_AI_BRIEF,
NAVER_AI_TAB,
NAVER_AI_MODE,
NAVER,
NAVER_SERP,
COMMERCE_SERP,
COMMERCE_PRODUCT,
BING_SEARCH,
BRAVE_SEARCH,
BING,
COPILOT,
BING_COPILOT,
MICROSOFT_COPILOT,
BING_AIMODE,
BING_COPILOT_SEARCH,
COPILOT_SEARCH,
META_AI,
QWEN,
DOUBAO,
BAIDU_WENXIN,
BAIDU_AI_SEARCH,
CITATION_ANALYSIS,
GEO_AUDIT,
SOURCE_INFLUENCE,
CITATION_ATTRIBUTION,
PROMPT_RESEARCH,
GEO_SCORE,
SEARCH,
WEB_SEARCH,
WEB_SCRAPE
Allowed value: "COMMERCE_SERP"
payload
object
必須

The payload for the selected taskType; see TaskInput for the engine-specific schema.

idempotencyKey
string

Optional. Deduplicates submissions for at least 30 days after the request. Omit for no deduplication. A duplicate is a 409 on this endpoint, but a success on the batch endpoint.

priority
integer
デフォルト:1

Compatibility field; does not guarantee execution order. Values outside 1–10 are clamped, not rejected.

必須範囲: 1 <= x <= 10
webhook
object

Optional. Omit to collect the result by polling instead.

レスポンス

Batch processed. Inspect results[] for per-task outcomes.

success
boolean
必須
summary
object
必須
results
object[]
必須

Positionally 1:1 with the submitted array, via index.