API Documentation | UcBot Like API

v1.2

Overview

All endpoints use GET only — pass every parameter in the URL query string. Default server is BD.

BASE URL https://fflikes.ucbot.net

GET /like GET /like200 GET /subscribe GET /status

Authentication

All requests require an API key via the api_key query parameter.

Example

code

https://fflikes.ucbot.net/status?api_key=your_api_key_here

https://fflikes.ucbot.net/status?api_key=your_api_key_here

Contact admin to get your API key.

Endpoints Overview

Method	Endpoint	Description
GET	`/like`	Send 100 likes (costs 1 limit)
GET	`/like200`	Send up to 200 likes (costs 1–2 limit)
GET	`/subscribe`	Create daily likes subscription
GET	`/subscriptions`	List your subscriptions
GET	`/subscribe/cancel`	Cancel a subscription
GET	`/status`	Account usage & billing
GET	`/me`	Alias for `/status`
GET	`/docs`	This documentation page

GET /like — 100 Likes

GET /like

Parameters

Name	Required	Description
`api_key`	Yes	Your API key
`uid`	Yes	Target player UID
`server_name`	No	Default: `BD`

Example URL

code

https://fflikes.ucbot.net/like?api_key=your_api_key_here&uid=1234567890

https://fflikes.ucbot.net/like?api_key=your_api_key_here&uid=1234567890

Example Response

code

{
  "success": true,
  "data": {
    "LikesGivenByAPI": 5,
    "LikesafterCommand": 105,
    "LikesbeforeCommand": 100,
    "PlayerNickname": "PlayerName",
    "UID": 1234567890,
    "status": 1,
    "server_name": "BD",
    "counted_toward_limit": 1,
    "remaining_today": 9,
    "daily_limit": 10
  }
}

{
  "success": true,
  "data": {
    "LikesGivenByAPI": 5,
    "LikesafterCommand": 105,
    "LikesbeforeCommand": 100,
    "PlayerNickname": "PlayerName",
    "UID": 1234567890,
    "status": 1,
    "server_name": "BD",
    "counted_toward_limit": 1,
    "remaining_today": 9,
    "daily_limit": 10
  }
}

status: 1 = success (counts toward limit). status: 2 = no likes given (does not count).

GET /like200 — 200 Likes

GET /like200

Sends up to 200 likes. Costs 1–2 limit units depending on how many likes are delivered.

Parameters

Name	Required	Description
`api_key`	Yes	Your API key
`uid`	Yes	Target player UID
`server_name`	No	Default: `BD`

Example URL

code

https://fflikes.ucbot.net/like200?api_key=your_api_key_here&uid=1234567890

https://fflikes.ucbot.net/like200?api_key=your_api_key_here&uid=1234567890

Example Response

code

{
  "success": true,
  "data": {
    "LikesGivenByAPI": 12,
    "LikesafterCommand": 212,
    "LikesbeforeCommand": 200,
    "PlayerNickname": "PlayerName",
    "UID": 1234567890,
    "status": 1,
    "server_name": "BD",
    "counted_toward_limit": 2,
    "remaining_today": 8,
    "daily_limit": 10
  }
}

{
  "success": true,
  "data": {
    "LikesGivenByAPI": 12,
    "LikesafterCommand": 212,
    "LikesbeforeCommand": 200,
    "PlayerNickname": "PlayerName",
    "UID": 1234567890,
    "status": 1,
    "server_name": "BD",
    "counted_toward_limit": 2,
    "remaining_today": 8,
    "daily_limit": 10
  }
}

GET /subscribe — Daily Subscription

GET /subscribe

Schedule automatic likes every day at 04:00 BD time. If the UID has not received any likes today, the first delivery is sent immediately when you subscribe (1 day is deducted). The next delivery is at 04:00 BD time.

Parameters

Name	Required	Description
`api_key`	Yes	Your API key
`uid`	Yes	Target player UID
`days`	Yes	Number of days (e.g. 30)
`likes`	Yes	`100` or `200` per day

Example — 100 likes for 30 days

code

https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=30&likes=100

https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=30&likes=100

Example — 200 likes for 7 days

code

https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=7&likes=200

https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=7&likes=200

Example Response

code

{
  "success": true,
  "data": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "target_uid": "1234567890",
    "likes_per_day": 100,
    "total_days": 30,
    "days_sent": 1,
    "days_remaining": 29,
    "successful_sends": 1,
    "is_active": true,
    "next_send_at": "2026-06-12 22:00:00",
    "schedule": "Every day 04:00 BD time",
    "first_send": {
      "immediate_send": true,
      "sent": true,
      "status": 1,
      "likes_given": 5
    },
    "message": "First 100 likes sent now. Next delivery at 04:00 BD time."
  }
}

{
  "success": true,
  "data": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "target_uid": "1234567890",
    "likes_per_day": 100,
    "total_days": 30,
    "days_sent": 1,
    "days_remaining": 29,
    "successful_sends": 1,
    "is_active": true,
    "next_send_at": "2026-06-12 22:00:00",
    "schedule": "Every day 04:00 BD time",
    "first_send": {
      "immediate_send": true,
      "sent": true,
      "status": 1,
      "likes_given": 5
    },
    "message": "First 100 likes sent now. Next delivery at 04:00 BD time."
  }
}

GET /subscriptions — List Subscriptions

GET /subscriptions

Parameters

Name	Required	Description
`api_key`	Yes	Your API key
`active_only`	No	`true` to show only active

Example URL

code

https://fflikes.ucbot.net/subscriptions?api_key=your_api_key_here

https://fflikes.ucbot.net/subscriptions?api_key=your_api_key_here

Example — active only

code

https://fflikes.ucbot.net/subscriptions?api_key=your_api_key_here&active_only=true

https://fflikes.ucbot.net/subscriptions?api_key=your_api_key_here&active_only=true

Example Response

code

{
  "success": true,
  "data": [
    {
      "id": "665f1a2b3c4d5e6f7a8b9c0d",
      "target_uid": "1234567890",
      "likes_per_day": 100,
      "total_days": 30,
      "days_sent": 5,
      "days_remaining": 25,
      "successful_sends": 4,
      "is_active": true,
      "next_send_at": "2026-06-12 00:00:00",
      "schedule": "Every day 04:00 BD time"
    }
  ]
}

{
  "success": true,
  "data": [
    {
      "id": "665f1a2b3c4d5e6f7a8b9c0d",
      "target_uid": "1234567890",
      "likes_per_day": 100,
      "total_days": 30,
      "days_sent": 5,
      "days_remaining": 25,
      "successful_sends": 4,
      "is_active": true,
      "next_send_at": "2026-06-12 00:00:00",
      "schedule": "Every day 04:00 BD time"
    }
  ]
}

GET /subscribe/cancel — Cancel Subscription

GET /subscribe/cancel

Parameters

Name	Required	Description
`api_key`	Yes	Your API key
`uid`	Yes	Target player UID (same as `/subscribe`)

Example URL

code

https://fflikes.ucbot.net/subscribe/cancel?api_key=your_api_key_here&uid=1234567890

https://fflikes.ucbot.net/subscribe/cancel?api_key=your_api_key_here&uid=1234567890

Example Response

code

{
  "success": true,
  "data": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "target_uid": "1234567890",
    "is_active": false,
    "deactivated_reason": "cancelled"
  }
}

{
  "success": true,
  "data": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "target_uid": "1234567890",
    "is_active": false,
    "deactivated_reason": "cancelled"
  }
}

GET /status — Account Status

GET /status or /me

Returns today's usage plus 3 separate months of billing — each month has its own group-use count and amount.

Parameters

Name	Required	Description
`api_key`	Yes	Your API key

Example URL

code

https://fflikes.ucbot.net/status?api_key=your_api_key_here

https://fflikes.ucbot.net/status?api_key=your_api_key_here

Example (alias)

code

https://fflikes.ucbot.net/me?api_key=your_api_key_here

https://fflikes.ucbot.net/me?api_key=your_api_key_here

Example Response

code

{
  "success": true,
  "account": {
    "name": "John Doe",
    "is_active": true,
    "member_since": "2026-06-01"
  },
  "usage": {
    "daily_limit": 50,
    "used_today": 3,
    "remaining_today": 47,
    "can_make_request": true
  },
  "billing": {
    "rate_per_group_use": 4.0
  },
  "monthly_billing": [
    {
      "month": "2026-06",
      "month_label": "June 2026",
      "group_uses": 12,
      "rate_per_use": 4.0,
      "amount": 48.0,
      "payment_status": "due"
    },
    {
      "month": "2026-05",
      "month_label": "May 2026",
      "group_uses": 30,
      "rate_per_use": 4.0,
      "amount": 120.0,
      "payment_status": "paid"
    },
    {
      "month": "2026-04",
      "month_label": "April 2026",
      "group_uses": 0,
      "rate_per_use": 4.0,
      "amount": 0,
      "payment_status": "none"
    }
  ],
  "subscriptions": {
    "active": [...],
    "total_active": 1
  },
  "recent_activity": [...]
}

{
  "success": true,
  "account": {
    "name": "John Doe",
    "is_active": true,
    "member_since": "2026-06-01"
  },
  "usage": {
    "daily_limit": 50,
    "used_today": 3,
    "remaining_today": 47,
    "can_make_request": true
  },
  "billing": {
    "rate_per_group_use": 4.0
  },
  "monthly_billing": [
    {
      "month": "2026-06",
      "month_label": "June 2026",
      "group_uses": 12,
      "rate_per_use": 4.0,
      "amount": 48.0,
      "payment_status": "due"
    },
    {
      "month": "2026-05",
      "month_label": "May 2026",
      "group_uses": 30,
      "rate_per_use": 4.0,
      "amount": 120.0,
      "payment_status": "paid"
    },
    {
      "month": "2026-04",
      "month_label": "April 2026",
      "group_uses": 0,
      "rate_per_use": 4.0,
      "amount": 0,
      "payment_status": "none"
    }
  ],
  "subscriptions": {
    "active": [...],
    "total_active": 1
  },
  "recent_activity": [...]
}

Daily Limit Rules

Default server: BD (no parameter needed)
Daily limit counts successful requests only (status: 1)
/like success → 1 limit unit
/like200 success → 1–2 limit units (only successful groups count)
Partial /like200: if only 1 group delivers likes, only 1 limit unit is charged
Daily limits reset at 04:00 BD time
Target UID max 200 likes/day — 2× /like or 1× /like200 (resets 04:00 BD)
Groups rotate round-robin across requests
Same UID cannot receive likes from the same group twice per day
Subscriptions send at 04:00 BD time daily
API key inactive → subscriptions stop automatically

Error Codes

Code	Meaning
`400`	Missing or invalid parameters
`401`	API key not provided
`403`	Invalid/deactivated key or UID blocked
`429`	Daily limit reached
`503`	No account group available
`500`	Server or upstream error

All Endpoint Examples (cURL)

Copy any example below and replace your_api_key_here with your real API key.

/like

code

curl "https://fflikes.ucbot.net/like?api_key=your_api_key_here&uid=1234567890"

curl "https://fflikes.ucbot.net/like?api_key=your_api_key_here&uid=1234567890"

/like200

code

curl "https://fflikes.ucbot.net/like200?api_key=your_api_key_here&uid=1234567890"

curl "https://fflikes.ucbot.net/like200?api_key=your_api_key_here&uid=1234567890"

/subscribe (100 likes × 30 days)

code

curl "https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=30&likes=100"

curl "https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=30&likes=100"

/subscribe (200 likes × 7 days)

code

curl "https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=7&likes=200"

curl "https://fflikes.ucbot.net/subscribe?api_key=your_api_key_here&uid=1234567890&days=7&likes=200"

/subscriptions

code

curl "https://fflikes.ucbot.net/subscriptions?api_key=your_api_key_here"

curl "https://fflikes.ucbot.net/subscriptions?api_key=your_api_key_here"

/subscribe/cancel

code

curl "https://fflikes.ucbot.net/subscribe/cancel?api_key=your_api_key_here&uid=1234567890"

curl "https://fflikes.ucbot.net/subscribe/cancel?api_key=your_api_key_here&uid=1234567890"

/status

code

curl "https://fflikes.ucbot.net/status?api_key=your_api_key_here"

curl "https://fflikes.ucbot.net/status?api_key=your_api_key_here"

/me (alias)

code

curl "https://fflikes.ucbot.net/me?api_key=your_api_key_here"

curl "https://fflikes.ucbot.net/me?api_key=your_api_key_here"