API Documentation
Integrate FollowTurk products and services into your own platform via our REST API.
Quick Start
Start using the FollowTurk API in 3 easy steps:
1
Request API Key
Fill the form below to request access
2
Get Approved
Our team will review your application
3
Start Building
Use your key to access all endpoints
Authentication
All API requests require an API key. You can send it in the following ways:
# Authorization header (recommended)
curl -H "Authorization: Bearer ftk_your_api_key" https://followturk.com/api/v1/products
# X-API-Key header
curl -H "X-API-Key: ftk_your_api_key" https://followturk.com/api/v1/products
# Query parameter
curl "https://followturk.com/api/v1/products?api_key=ftk_your_api_key"Endpoints
Base URL: https://followturk.com/api/v1
| Method | Endpoint | Description |
|---|---|---|
| GET | /categories |
List all categories |
| GET | /categories/{id} |
Category details with products |
| GET | /products |
List products (filterable) |
| GET | /products/{id} |
Product details |
| POST | /orders |
Create a new order |
| GET | /orders |
List your orders |
| GET | /orders/{id} |
Order details & status |
| GET | /account |
Account info & balance |
| GET | /export/products.xml |
Export products as XML |
| GET | /export/products.csv |
Export products as CSV |
GET /products
List products with filtering, sorting, and pagination.
| Parameter | Type | Description |
|---|---|---|
category_id | integer | Filter by category ID |
search | string | Search by name |
in_stock | 0/1 | Only in-stock products |
sort | string | price_asc, price_desc, name_asc, name_desc, newest |
page | integer | Page number (default: 1) |
per_page | integer | Items per page (max: 100) |
POST /orders
Create a new order. Payment is deducted from your account balance.
{
"items": [
{
"product_id": 42,
"quantity": 1000,
"customer_input": "https://instagram.com/username"
}
],
"coupon_code": "SAVE10",
"payment_method": "balance"
}| Field | Required | Description |
|---|---|---|
items[].product_id | Yes | Product ID |
items[].quantity | No | Quantity (default: 1) |
items[].customer_input | Conditional | URL/username for SMM products |
coupon_code | No | Discount coupon code |
payment_method | No | "balance" only |
Response Format
// Success
{
"success": true,
"message": "Products retrieved.",
"data": [...],
"meta": { "total": 50, "page": 1, "per_page": 20 }
}
// Error
{
"success": false,
"error": { "code": 422, "message": "Insufficient balance." }
}Error Codes
200 | Success |
401 | Unauthorized - Invalid or missing API key |
404 | Not Found |
422 | Validation Error - Invalid parameters |
429 | Rate Limited - Too many requests |
500 | Server Error |
Request API Key
To use the API, you need an API key. You can request one from your account settings.
Log In & Request API Key
Added to Cart!
Language Detected!