(Agent) Task Creation

POST

{{baseUrl}}/api/agentic/search

Last modified:2026-07-16 18:26:01

Create an agent-mode lead-generation task (asynchronous). Integrates 100+ global data channels (customs, social media, trade shows, search engines, corporate contact databases, tenders/bids, yellow pages, maps, independent websites, etc.) and intelligently filters potential customers and partners based on company profiles. Searches typically complete in 1-2 hours. Call the task list API to retrieve the task execution status (whether the search is complete).

Request

Header Params

Body Params application/json

Example

{
  "keyword": "coffee roaster",
  "country": "USA",
  "cr": "countryUS",
  "lang": "English",
  "positioning": "1",
  "expandKeyWord": [
    "coffee machine"
  ],
  "secondKeyWord": [
    "OEM"
  ],
  "clientPortrait": "Medium-to-large coffee equipment buyers",
  "information": "Prioritize companies with import history",
  "hscode": "841981",
  "jobEnhanceSearch": "purchasing manager"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '{{baseUrl}}/api/agentic/search' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "keyword": "coffee roaster",
  "country": "USA",
  "cr": "countryUS",
  "lang": "English",
  "positioning": "1",
  "expandKeyWord": [
    "coffee machine"
  ],
  "secondKeyWord": [
    "OEM"
  ],
  "clientPortrait": "Medium-to-large coffee equipment buyers",
  "information": "Prioritize companies with import history",
  "hscode": "841981",
  "jobEnhanceSearch": "purchasing manager"
}'

Responses

🟢201已创建

application/json

Bodyapplication/json

Example

{
  "code": 1,
  "message": "Task created successfully",
  "taskId": "641230a80434415d9c07d54db411cb5d",
  "serverTime": "2026-04-15 16:14:10",
  "meta": {
    "billing": {
      "credits_charged": 0,
      "agentic_note": "search only creates tasks; per-item charges are applied when subsequent list/task responses contain billable data, and charging is idempotent to prevent duplicate deductions; the list/task HTTP itself does not deduct credits per request."
    }
  }
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

Modified at 2026-07-16 18:26:01

Agentic Tasks

(Agent) Task List