Skip to content
T
Tools.Town
Free Online Tools for Everyone

Find and Replace API

Find and replace across a block of text — plain or full regex with back-references, case toggle, multiline mode.

Category: Text Tools Endpoint: /v1/text/find-replace 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/find-replace

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
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