API Documentation

Integrate IndexTensor into your applications with our simple REST API.

Authentication

All API requests require Bearer token authentication. Include your API token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Sign in to get your API token.

Endpoints

POST /api/links

Submit links for indexing. Links can be provided as a semicolon-separated string or as an array.

Request Body

// Option 1: Semicolon-separated string
{
  "links": "https://example.com/page1;https://example.com/page2"
}

// Option 2: Array of links
{
  "links": [
    "https://example.com/page1",
    "https://example.com/page2"
  ]
}

Success Response (200)

{
  "status": 200,
  "msg": "Task created successfully",
  "data": {
    "units_used": 4,
    "task_id": "1721392204",
    "links_count": 4
  }
}

Error Codes

Code Description
400 Invalid data provided (malformed JSON, invalid URLs)
401 Missing or malformed Authorization header
403 Invalid API token
404 Endpoint not found
405 Insufficient balance
429 Rate limit exceeded
500 Internal server error

Error Response Format

{
  "status": 400,
  "message": "Task wasn't created: Invalid data provided"
}

Rate Limits & Constraints

  • Max links per request: 20,000
  • Max URL length: 2,000 characters
  • Supported protocols: http:// and https://
  • Cost: 1 unit per link
  • Rate limit: 60 requests per minute

Code Examples

curl -X POST https://indextensor.com/api/links \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"links": ["https://example.com/page1", "https://example.com/page2"]}'