GEO 验证 API

鉴权

每个请求带上你的 Key。Key 只发一次，丢了联系我们换新的。

Authorization: Bearer fgeo_xxxxxxxxxxxxxxxx

提交一批问题

POST/api/v1/ai/batch/create

一批最多 5000 条。同一个 batchNo 重复提交相同内容不会重复执行，内容不同会返回 409。

curl -X POST https://geo.flowan.cn/api/v1/ai/batch/create \
  -H "Authorization: Bearer $FLOWAN_GEO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "batchNo": "brand-check-001",
    "items": [
      {
        "itemId": "q1",
        "platformCode": "doubao",
        "seq": 1,
        "question": "三千元以内哪款扫地机器人值得买",
        "deepthink": false,
        "webSearch": true
      }
    ]
  }'

{
  "success": true,
  "code": 0,
  "message": "success",
  "data": {
    "externalBatchId": "acme-20261012T034525-a1e18bc30042",
    "acceptedCount": 1
  }
}

查进度

GET/api/v1/ai/batch/external/{externalBatchId}

status 为 0 待处理、1 处理中、2 已结束；resultStatus 给出真实结局。全部为 2 之后再取结果。

curl https://geo.flowan.cn/api/v1/ai/batch/external/{externalBatchId} \
  -H "Authorization: Bearer $FLOWAN_GEO_KEY"

{
  "success": true,
  "code": 200,
  "message": "success",
  "data": {
    "externalBatchId": "acme-20261012T034525-a1e18bc30042",
    "questions": [
      { "questionId": "q1", "status": 2, "resultStatus": "SUCCEEDED" }
    ],
    "summary": { "total": 1, "succeeded": 1, "failed": 0, "processing": 0 }
  }
}

取结果

GET/api/v1/ai/batch/external/{externalBatchId}/results

按条返回答案正文、引用来源和证据链接，每页最多 500 条。证据链接是临时地址，过期后重新调用即可。

curl "https://geo.flowan.cn/api/v1/ai/batch/external/{externalBatchId}/results?offset=0&limit=100" \
  -H "Authorization: Bearer $FLOWAN_GEO_KEY"

{
  "success": true,
  "code": 200,
  "message": "success",
  "data": {
    "externalBatchId": "acme-20261012T034525-a1e18bc30042",
    "batchNo": "brand-check-001",
    "total": 1,
    "offset": 0,
    "limit": 100,
    "results": [
      {
        "itemId": "q1",
        "seq": 1,
        "platformCode": "doubao",
        "question": "三千元以内哪款扫地机器人值得买",
        "status": 2,
        "resultStatus": "SUCCEEDED",
        "finishedAt": "2026-10-12T11:52:08+08:00",
        "answer": "……",
        "deepThought": "",
        "generatedAt": "2026年10月12日11:51",
        "recommendedQuestions": ["……"],
        "sources": [
          { "url": "https://example.com/review", "title": "……", "site_name": "……" }
        ],
        "evidence": {
          "recordingUrl": "https://…",
          "screenshotUrl": "https://…"
        }
      }
    ]
  }
}

取 Excel

GET/api/v1/ai/batch/external/{externalBatchId}/files

整批结束后返回一份合并好的 Excel，含「AI回答」和「溯源信息」两张表。未结束时 fileUrls 为空。

curl https://geo.flowan.cn/api/v1/ai/batch/external/{externalBatchId}/files \
  -H "Authorization: Bearer $FLOWAN_GEO_KEY"

{
  "success": true,
  "code": 200,
  "message": "success",
  "data": {
    "externalBatchId": "acme-20261012T034525-a1e18bc30042",
    "fileUrls": ["https://…/brand-check-001-result.xlsx"]
  }
}

字段

平台与价格

快速模式、深度思考同价，¥0.40 / 条。只有成功交付的条目计费，失败和取消的不收钱。

错误