Text Sorter API

Sort lines five ways — alphabetical, natural (item2 < item10), length, numeric, random shuffle. Reverse, case toggles, blank-line handling.

◎ Category: Text Tools ◎ Endpoint: /v1/text/sort-lines Method: POST Auth: API Key

Fast & Accurate

Get precise results instantly.

Easy Integration

Simple REST API with JSON response.

Developer Friendly

Clear docs and SDK examples.

Free to Start

5,000 free requests/month.

Endpoint

All requests should be made to the following endpoint:

POST https://api.tools.town/v1/text/sort-lines

Authentication

This endpoint requires an API Key. Include your API key in the request header.

Authorization: Bearer YOUR_API_KEY

You can get your API key from your dashboard.

Request Parameters

Send a POST request with JSON body.

Parameter	Type	Required	Description	Example
`text`	`string`	✓	The text parameter.	`Hello World`
`mode`	`enum`	✕	The mode parameter.	`alpha`
`reverse`	`boolean`	✕	The reverse parameter.	`true`
`caseSensitive`	`boolean`	✕	The caseSensitive parameter.	`true`
`removeBlanks`	`boolean`	✕	The removeBlanks parameter.	`true`

Example Request

curl -X POST "https://api.tools.town/v1/text/sort-lines" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello World"
  }'

import requests

response = requests.post(
    "https://api.tools.town/v1/text/sort-lines",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "text": "Hello World"
    }
)
print(response.json())

<?php
$ch = curl_init("https://api.tools.town/v1/text/sort-lines");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer YOUR_API_KEY",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  "text" => "Hello World"
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;

const response = await fetch("https://api.tools.town/v1/text/sort-lines", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "Hello World"
  }),
});

const data = await response.json();
console.log(data);

const fetch = require("node-fetch");

const response = await fetch("https://api.tools.town/v1/text/sort-lines", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "Hello World"
  }),
});

const data = await response.json();
console.log(data);

Example Response 200 OK

application/json

{
  "success": true,
  "data": {
    "output": "string",
    "inputLines": "0",
    "outputLines": "0",
    "mode": "string"
  }
}

Error Codes

Code	Meaning
400	Bad Request — missing or invalid parameter
401	Unauthorized — API key missing or invalid
429	Rate limit exceeded — free tier: 5,000 requests/month
500	Internal Server Error — try again or contact support

All API Tools Try Text Sorter →

AI Text Summarizer

AI Image Packs