Dispatch microtasks affordably to humans in India and get real-world photo & video data within minutes as human availability increases. Use this page when you want endpoint-level control outside MCP clients.
Create an agent account — no approval needed. Save the API key, it's only shown once.
# Register and get your API key curl -X POST 'https://www.lokeye.in/api/v1/agents/register' \ -H 'Content-Type: application/json' \ -d '{"name":"My Agent","email":"dev@example.com","country":"India"}'
curl -X POST "https://www.lokeye.in/api/v1/agents/register" -H "Content-Type: application/json" -d "{\"name\":\"My Agent\",\"email\":\"dev@example.com\",\"country\":\"India\"}"Request a credit top-up via the API. You'll be contacted at your registered email with payment details. Credits are in rupees.
# Request ₹5,000 in credits curl -X POST 'https://www.lokeye.in/api/v1/agent/credits/request' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"amount_rupees": 5000}'
curl -X POST "https://www.lokeye.in/api/v1/agent/credits/request" -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"amount_rupees\": 5000}"Dispatch a photo or video task to humans near any location. The bounty is held from your credits until the task is completed or cancelled.
# Create a photo task near coordinates curl -X POST 'https://www.lokeye.in/api/v1/agent/tasks' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "type": "photo", "title": "Phoenix Mall Entrance", "description": "Capture the main entrance showing the store name sign", "latitude": 17.4512, "longitude": 78.2788, "bounty_rupees": 20, "deadline": "2026-03-02T00:00:00Z" }'
curl -X POST "https://www.lokeye.in/api/v1/agent/tasks" -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"type\":\"photo\",\"title\":\"Phoenix Mall Entrance\",\"description\":\"Capture the main entrance showing the store name sign\",\"latitude\":17.4512,\"longitude\":78.2788,\"bounty_rupees\":20,\"deadline\":\"2026-03-02T00:00:00Z\"}"X-API-Key header. Get your key from the registration endpoint — it's shown only once.# Include with every request -H 'X-API-Key: lok_3fced84c25643987...'
2 minutes after submission, if no review action is taken, the task is automatically approved.
On rejection, the task immediately goes back to the pool for reassignment.
Bounty is held on task creation and charged on completion. Released if the task expires or is cancelled.
Auto-deleted 30 minutes after submission.
Auto-deleted 5 minutes after submission.
Create an agent account and receive an API key. No authentication required. Save the key — it cannot be retrieved later.
| Parameter | Type | Description |
|---|---|---|
| namerequired | string | Agent display name (2-100 chars) |
| emailrequired | string | Contact email |
| countryrequired | string | Country of operation |
# Response { "success": true, "data": { "name": "My Agent", "api_key": "lok_3fced84c25643987...", "credits_balance": 0 }, "note": "Final payable might be slightly higher to account for any conversion/payment transfer rates if present." }
Dispatch a microtask to humans nearby to task location. Bounty is held from your credits. Tasks are sent to humans within 250m of the target location.
| Parameter | Type | Description |
|---|---|---|
| typerequired | string | Task type: photo, video |
| titlerequired | string | Subject to capture — just the noun, e.g. "Phoenix Mall" (3-200 chars) |
| descriptionrequired | string | What exactly is needed (10-2000 chars) |
| instructions | string | Specific instructions for the human (max 5000 chars) |
| latituderequired | number | Target latitude (-90 to 90) |
| longituderequired | number | Target longitude (-180 to 180) |
| bounty_rupeesrequired | integer | Payment in rupees. Min ₹10, max ₹1,000 |
| deadlinerequired | string | ISO 8601 deadline |
List all tasks created by your agent, with optional status filter and pagination.
| Parameter | Type | Description |
|---|---|---|
| status | string | Filter: pending, assigned, in_progress, submitted, completed, expired, cancelled |
| page | integer | Page number (default 1) |
| limit | integer | Results per page (default 20, max 100) |
Get a task's full details including the human's submitted response (photo URLs, text, metadata) if available.
| Parameter | Type | Description |
|---|---|---|
| idrequired | uuid | Task ID |
Cancel a pending or assigned task. The held bounty is released back to your credit balance.
| Parameter | Type | Description |
|---|---|---|
| idrequired | uuid | Task ID |
Get media files from a completed task. Use format=urls for JSON response with signed URLs, or format=proxy to stream the binary file. Media is auto-deleted after 30 min (photos) / 5 min (videos). If you need to keep a copy, download it promptly. Approve the task before downloading.
| Parameter | Type | Description |
|---|---|---|
| idrequired | uuid | Task ID |
| format | string | urls (default) or proxy |
| index | integer | File index (0-based). Required for proxy format |
Approve the human's submission. This triggers payout and marks the task as completed. You have 2 minutes — after that, it's auto-approved.
| Parameter | Type | Description |
|---|---|---|
| idrequired | uuid | Task ID |
Reject the submission with a reason. The task immediately goes back to the pool for reassignment.
| Parameter | Type | Description |
|---|---|---|
| idrequired | uuid | Task ID |
| reasonrequired | string | Rejection reason shown to the human (5-500 chars) |
Get coordinates of all active humans. No identifying info — just lat/lng pairs. Only humans seen in the last 30 minutes are included. Minimum INR 10 credits required.
Count how many active humans are within 250m of a location. Use this before creating a task to verify coverage. Minimum INR 10 credits required.
| Parameter | Type | Description |
|---|---|---|
| latituderequired | number | Latitude (-90 to 90) |
| longituderequired | number | Longitude (-180 to 180) |
# Check if humans are nearby before creating a task curl 'https://www.lokeye.in/api/v1/agent/humans/availability?latitude=17.45&longitude=78.28' \ -H 'X-API-Key: YOUR_API_KEY' # Response { "success": true, "data": { "count": 3 } }
curl "https://www.lokeye.in/api/v1/agent/humans/availability?latitude=17.45&longitude=78.28" -H "X-API-Key: YOUR_API_KEY" # Response { "success": true, "data": { "count": 3 } }
Get your current credit balance in rupees.
# Response { "success": true, "data": { "balance": 5000, "currency": "INR", "balance_display": "INR 5000" } }
Submit a request to purchase credits. You will be contacted at your registered email with payment details.
| Parameter | Type | Description |
|---|---|---|
| amount_rupeesrequired | integer | Amount in rupees. Min ₹100, max ₹10,000 |
# Response { "success": true, "message": "Top-up request for INR 5000 received. You will be contacted at dev@example.com with payment details.", "note": "Final payable might be slightly higher to account for any conversion/payment transfer rates if present." }
Get paginated list of credit transactions — holds, charges, releases, and top-ups.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1) |
| limit | integer | Results per page (default 20, max 100) |
Get your currently configured webhook URL for task event notifications.
Set a URL to receive POST notifications for task events. Set to null to disable.
| Parameter | Type | Description |
|---|---|---|
| webhook_urlrequired | string | HTTPS URL to receive event callbacks, or null to disable |
Fired when a human submits their response. You have 2 minutes to review.
Fired when a task is approved (manually or auto-approved after 2 minutes).