Bulk Range Text Replacement in Cloud Excel Files – Find & Replace API

Perform bulk text replacement across remote Excel files stored in the cloud. Find and update specific text strings within selected ranges efficiently using Aspose.Cells Find and Replace API.

Replace Content in Remote Range API

Web API

PUT https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/ranges/{cellArea}/replace/content

Request Parameters

Parameter Name	Type	Path/Query String/HTTP Body	Description
name	String	Path	The name of the workbook file stored in cloud storage to be modified (e.g., `"report.xlsx"`).
searchText	String	Query	The text string to search for within the specified worksheet and cell area. Supports exact text matching.
replaceText	String	Query	The text string that will replace all occurrences of the `searchText` within the specified range.
worksheet	String	Path	The name of the worksheet where the find‑and‑replace operation will be performed.
cellArea	String	Path	The specific cell range (e.g., `"A1:D20"`) where the text search and replacement will occur.
folder	String	Query	The cloud storage folder path where the source workbook is located.
storageName	String	Query	(Optional) The name of the cloud storage where the workbook resides. If omitted, the default cloud storage is used.
region	String	Query	(Optional) Sets the locale for text handling, which may affect case sensitivity and character encoding in search operations (e.g., `"en-US"`, `"tr-TR"`).
password	String	Query	(Optional) If the workbook is password‑protected, provide the password to open and modify the file.

Response

{
  "Name": "CellsCloudResponse",
  "Type": "Class",
  "Properties": [
    {
      "Name": "Code",
      "DataType": {
        "Identifier": "Integer"
      }
    },
    {
      "Name": "Status",
      "DataType": {
        "Identifier": "String"
      }
    }
  ]
}

Rate Limits & Throttling

The API allows 60 calls per minute per account. If the limit is exceeded, the service returns HTTP 429. Implement exponential back‑off and retry after the Retry-After header value.

Error Codes

Code	Message	When it occurs
400	Bad Request	The request URI or parameters are malformed.
401	Unauthorized	Missing or invalid authentication token.
404	Not Found	The specified workbook cannot be found or accessed.
500	Server Error	An internal server error while processing the workbook.

Where should we use the Replace content of Range in Remote Spreadsheet API?

Batch Cloud File Update: Modify the contents of multiple Excel files stored in cloud storage such as AWS S3 and Azure Blob.
Dynamic population of cloud templates: Batch‑populate dynamic data for report templates stored in the cloud.
Cross‑region file synchronization: Synchronize the content consistency of Excel files in cloud storage across different geographical regions.

Why should you use the Replace content of Range in Remote Spreadsheet API?

Developer‑Friendly: Aspose.Cells Cloud offers SDK libraries in multiple languages, enabling quick development and comes with comprehensive documentation. Compared with building custom solutions, this significantly reduces development workload.
Reduced Labor Costs: Decreases the need for dedicated positions handling document consolidation.
Pay‑per‑use: No upfront investment; you only pay for API calls actually used.
Zero Maintenance Costs: No need to maintain servers, update software, or deal with compatibility issues.
Preserves complex Excel formatting in a universally accessible PDF format.

How to Use the Replace content of Range in Remote Spreadsheet API with SDKs

OpenAPI Specification

The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.

Use Aspose.Cells Cloud SDKs

Using the SDK is the best way to accelerate development. The SDK handles the underlying details, allowing you to simply implement replace content in spreadsheets for cells with minimal code. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to make calls to Aspose.Cells web services using various SDKs:

// C# example – Replace text in a remote range
// (Insert actual SDK code here)

Java

// Java example – Replace text in a remote range
// (Insert actual SDK code here)

PHP

// PHP example – Replace text in a remote range
// (Insert actual SDK code here)

Ruby

# Ruby example – Replace text in a remote range
# (Insert actual SDK code here)

Node.js

// Node.js example – Replace text in a remote range
// (Insert actual SDK code here)

Python

# Python example – Replace text in a remote range
# (Insert actual SDK code here)

Perl

# Perl example – Replace text in a remote range
# (Insert actual SDK code here)

// Go example – Replace text in a remote range
// (Insert actual SDK code here)

Frequently Asked Questions

How do I authenticate when calling the Replace Content in Remote Range API?

First obtain an access token by POSTing your **client_id** and **client_secret** to `https://api.aspose.cloud/connect/token`. Then include the header `Authorization: Bearer ` in every request, including the Replace Content call.

What is the required format for the cellArea parameter?

`cellArea` must be a valid Excel range string like `"A1:D20"` (uppercase column letters, colon, row numbers). Partial ranges such as `"A:C"` or `"1:10"` are also accepted.

What response indicates a successful replace operation?

A successful call returns HTTP 200 with JSON `{ "Code": 200, "Status": "OK" }`. The `Code` field mirrors the HTTP status, while `Status` provides a human‑readable message.