GEO Score

POST

geo-score

curl --request POST \
  --url https://api.querying.ai/v1/geo-score \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://www.allbirds.com/products/mens-tree-runners",
  "country": "US"
}
'

{
  "success": true,
  "task": {
    "id": "0b6c1f7e-2d4a-4c55-9a0e-3f1d2b7c8e91",
    "taskType": "GEO_SCORE",
    "status": "QUEUED",
    "priority": 1,
    "createdAt": "2026-10-21T09:00:00.000Z"
  },
  "credits": {
    "creditsToCharge": 0,
    "creditsCharged": 0
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

承認

Authorization

string

header

必須

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

ボディ

application/json

url

string<uri>

必須

The page to score: an http or https URL on a public host, on the default port.

Maximum string length: 2048

country

enum<string>

デフォルト:US

Where the person reading the page is. The page is rendered from an address in that country, in its language and time zone. Any other value is a 422 REGION_UNSUPPORTED.

利用可能なオプション:

US,

KR

idempotencyKey

string

Optional. Deduplicates submissions; a duplicate is a 409.

priority

integer

デフォルト:1

Optional. Echoed in task metadata; values outside 1-10 are clamped. It does not guarantee execution order.

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

webhook

object

Optional. Omit to collect the result by polling instead.

Show child attributes

レスポンス

Queued; poll /v1/async/task/{id}. Its response follows GeoScoreResult.

success

boolean

必須

task

object

必須

Show child attributes

credits

object

必須

Credits, with up to two decimals (for example 1.25). The submit response always shows 0: a hold is placed on your balance, but nothing is charged yet. Polling shows 0 until the task is terminal, then the settled charge: the task's price for COMPLETED, 0 for FAILED. A task webhook reports the same charge in creditsCharged; on a FAILED task it reports the task's price in creditsToCharge and 0 in creditsCharged. CITATION_ANALYSIS and WEB_CRAWL are charged by usage, up to the hold placed at submit.

Show child attributes

curl --request POST \
  --url https://api.querying.ai/v1/geo-score \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://www.allbirds.com/products/mens-tree-runners",
  "country": "US"
}
'

{
  "success": true,
  "task": {
    "id": "0b6c1f7e-2d4a-4c55-9a0e-3f1d2b7c8e91",
    "taskType": "GEO_SCORE",
    "status": "QUEUED",
    "priority": 1,
    "createdAt": "2026-10-21T09:00:00.000Z"
  },
  "credits": {
    "creditsToCharge": 0,
    "creditsCharged": 0
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

タスク

バッチ

位置グリッド

リサーチ

AI Rendering

モニター

エクスポート

サブアカウント

運用

承認

ボディ

レスポンス