Canonical paths
| Purpose | URL |
|---|---|
| API endpoint | https://botfarm.agdor.info/api |
| Telegram webhook/bot route | https://botfarm.agdor.info/bot |
| Documentation | https://botfarm.agdor.info/api_docs |
Compatibility paths
Old .php routes remain available for existing integrations, but new integrations should use the canonical paths.
/api.php /bot.php /docs ?fr=api ?fr=bot ?fr=api_docs
Authentication
API requests require a user API key. Telegram remains the primary workflow; API is for automation and scale.
GET/POST https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=ACTION
Use POST for creating tasks and payments. Use GET for balance, tariffs, engines, and status checks.
1. Account and tariffs
action=stats GET
{
"status": "success",
"data": {
"telegram_id": 12345678,
"affiliate_balance": 25.5,
"active_bots": [
{ "typeb": "google", "total": "850" },
{ "typeb": "bing", "total": "200" }
]
}
}
action=tariffs GET
{
"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
{
"status": "success",
"data": ["google", "bing", "openai"]
}
2. Links and tasks
action=add_links POST
| Parameter | Description |
|---|---|
engine | Search engine type. Use google, bing, or comma-separated values when balance allows it. |
links | URL list, one URL per line. |
curl -X POST "https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=add_links" \ -d "engine=google" \ --data-urlencode "links=https://example.com/page-1"
action=check_status GET
https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=check_status&task_id=456
action=list_tasks GET
https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=list_tasks&page=1&limit=50
3. Payments
action=payment_methods GET
Returns available payment methods and wallets.
action=create_payment POST
| Parameter | Description |
|---|---|
tariff_id | Tariff id from action=tariffs. |
network or wallet_code | Payment method selected from payment_methods. |
action=check_payment GET
https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=check_payment&invoice_id=inv_...
hash=inv_... is still accepted as a legacy alias.
4. Affiliate program
action=affiliate_stats GET
action=withdraw_affiliate POST
Affiliate endpoints are available to authenticated users with a valid API key.