Find and Replace API
Find and replace across a block of text — plain or full regex with back-references, case toggle, multiline mode.
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/find-replace Authentication
This endpoint requires an API Key. Include your API key in the request header.
Request Parameters
Send a POST request with JSON body.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
text | string | ✓ | The text parameter. | Hello World |
find | string | ✓ | The find parameter. | example |
replace | string | ✕ | The replace parameter. | example |
mode | enum | ✕ | The mode parameter. | plain |
caseSensitive | boolean | ✕ | The caseSensitive parameter. | true |
multiline | boolean | ✕ | The multiline parameter. | true |
Example Request
curl -X POST "https://api.tools.town/v1/text/find-replace" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Hello World",
"find": "example"
}' 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 |