API Documentation

Primary URLs

Authentication

To authenticate requests, pass your API key in the key parameter (GET or POST). You can obtain your key in your account dashboard.

GET / POST https://agdindex.com/api?key=YOUR_API_KEY&action=ACTION

Use POST for creating tasks, payments, and requests. Use GET for balance, tariffs, engines, lists, and status checks.

Response format

Successful responses return status=success and a data field. Errors return status=error and message. URL submission may return status=partial_error when only part of the request was completed.

{
  "status": "success",
  "data": {}
}

{
  "status": "error",
  "message": "Error description"
}

1. Account and tariffs

action=stats GET

Returns Telegram ID, affiliate balance, and active bot balances grouped by engine. Aliases: check_balance

{
  "status": "success",
  "data": {
    "user_id": 5,
    "email": "[email protected]",
    "telegram_id": 12345678,
    "affiliate_balance": 25.5,
    "active_bots": [
      { "typeb": "google", "total": 850 },
      { "typeb": "bing", "total": 200 }
    ]
  }
}

action=tariffs GET

Returns available tariffs grouped by engine. The price already includes the discount and is rounded to an integer value.

{
  "status": "success",
  "data": {
    "google": [
      { "id": 1, "bots": 2000, "price": 10 },
      { "id": 2, "bots": 5000, "price": 24 }
    ],
    "bing": [
      { "id": 6, "bots": 2000, "price": 10 }
    ]
  }
}

action=engines GET

Returns the list of available indexing engines.

{
  "status": "success",
  "data": ["google", "bing", "openai"]
}

2. Links and tasks

action=add_links POST

curl -X POST "https://agdindex.com/api?key=YOUR_API_KEY&action=add_links" \
  -d "engine=google" \
  --data-urlencode "links=https://example.com/page-1"

Success response example:

{
  "status": "success",
  "results": {
    "google": {
      "status": "success",
      "task_id": 4972,
      "urls": 2,
      "dispatch_status": "pending"
    }
  }
}

Insufficient bot balance response (status: partial_error):

{
  "status": "partial_error",
  "results": {
    "google": {
      "status": "error",
      "code": "insufficient_bot_balance",
      "engine": "google",
      "required": 200,
      "available": 150,
      "missing": 50,
      "message": "Insufficient Google bot balance. 50 additional bots required."
    }
  }
}

action=check_status GET

Returns task progress, sent URL count, farm dispatch status, and completion state.

https://agdindex.com/api?key=YOUR_API_KEY&action=check_status&task_id=456

action=list_tasks GET

Returns the user task list with pagination. Default limit is 10, maximum limit is 100.

https://agdindex.com/api?key=YOUR_API_KEY&action=list_tasks&page=1&limit=10

action=task_log GET

Returns the task execution log when the task has already been dispatched to the farm.

https://agdindex.com/api?key=YOUR_API_KEY&action=task_log&task_id=456

3. Payments

action=payment_methods GET

Returns available payment methods, networks, and wallets. Aliases: networks

action=create_payment POST

Creates an invoice for the selected tariff.

action=check_payment GET

Checks invoice status. Use invoice_id for new integrations.

https://agdindex.com/api?key=YOUR_API_KEY&action=check_payment&invoice_id=inv_...

hash=inv_... is still accepted as a legacy alias.

4. Affiliate program

Affiliate methods are available to users with a valid API key.

action=affiliate_stats GET

action=withdraw_affiliate POST

Creates an affiliate withdrawal request. Minimum withdrawal amount is 10 USDT.