Skip to content
Tools.Town
290+ free online tools

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:

POSThttps://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.

ParameterTypeRequiredDescriptionExample
textstringThe text parameter.Hello World
findstringThe find parameter.example
replacestringThe replace parameter.example
modeenumThe mode parameter.plain
caseSensitivebooleanThe caseSensitive parameter.true
multilinebooleanThe 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

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