NeuroCaptcha

getTaskResult

Returns the task status and, once it is ready, the token, its cost and timestamps. Results are kept for 10 minutes.

Цей розділ показано англійською.

На цій сторінці
Endpoint
POST https://neurocaptcha.com/getTaskResult

Request#

clientKey
stringобов’язковий
Your API key.
taskId
integerобов’язковий
taskId from createTask. A number, not a string.

Example#

import requests

response = requests.post("https://neurocaptcha.com/getTaskResult", json={
    "clientKey": "YOUR_API_KEY",
    "taskId": 7781,
}, timeout=30)
print(response.json())

Response#

In progress#

processing
{
  "errorId": 0,
  "status": "processing"
}

Ready#

ready
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AFcWeA6Z3vq0VhGm1oS8r0bAxKk4…",
    "userAgent": ""
  },
  "cost": "0.000600",
  "ip": "198.51.100.7",
  "createTime": 1793370000,
  "endTime": 1793370007,
  "solveCount": 1
}
status
string
processing or ready.
solution.gRecaptchaResponse
string
The token.
solution.userAgent
string
userAgent from the task (empty if you did not pass one).
solution.cookies
object
Cookies set during solving, when there are any.
cost
string
Charged amount in USD with 6 decimals (0.000000 for test keys).
ip
string
IP address the task was created from.
createTime
integer
When the task was created, Unix time.
endTime
integer
When it was solved, Unix time.
solveCount
integer
Solving attempts used.

Failed#

A task that failed answers with its error code, and the task is not charged. Create a new task:

error
{
  "errorId": 12,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "the task could not be solved"
}

Polling#

  • Poll each task every 2–3 seconds; more often does not make it faster.
  • The key may make up to 50 getTaskResult calls per second in total; above it ERROR_TOO_MUCH_REQUESTS.
  • Stop at ready or at the first error — a finished task does not change.
  • The result is kept for 10 minutes after it is ready, then the answer is ERROR_NO_SUCH_CAPCHA_ID.
  • With many tasks in parallel, webhooks save requests.