Search Text in Remote Excel Spreadsheets – Find Specific Data

Search Content in Remote Spreadsheet API

Programmatically search for specific text within any Excel spreadsheet using the Aspose.Cells Cloud API. Find text, numbers, or formulas in files stored in cloud storage. This RESTful API enables automated data discovery, content analysis, and spreadsheet‑auditing workflows.

Web API

PUT https://api.aspose.cloud/v4.0/cells/{name}/search/content

Request Parameters:

Parameter Name Type Path/Query String/HTTPBody Description
name String Path Required. The filename of the Excel workbook (including extension) where the text search will be performed, e.g., sales_data.xlsx.
searchText String Query Required. The exact string, number, or partial content to locate across the entire workbook or worksheet(s).
ignoringCase Boolean Query Optional. Determines case‑sensitivity. Set to true for case‑insensitive matching (e.g., “Report” matches “REPORT”); default is false.
folder String Query Optional. The directory path within your cloud storage that contains the target workbook. If omitted, the root folder is assumed.
storageName String Query Optional. The name identifier for a custom‑configured cloud storage service. If not specified, the API uses the default storage associated with the account.
region String Query Optional. The locale setting (e.g., es-ES) applied during the search, which may affect text normalization or collation rules.
password String Query Optional. The decryption password required to access a password‑protected Excel file. Omit this parameter if the file is not encrypted.

Glossary

  • searchText – The exact string to locate; can be a partial match.
  • ignoringCase – true makes the search case‑insensitive; false enforces case‑sensitivity.
  • folder – Path to the directory that holds the workbook.
  • storageName – Identifier of a custom storage configuration.
  • region – Locale code that influences text comparison rules.
  • password – Decryption password for protected workbooks.

Response

{
  "Cells": [
    {
      "CellName": "A1",
      "WorksheetName": "Sheet1",
      "Text": "Report"
    },
    {
      "CellName": "B5",
      "WorksheetName": "Sheet2",
      "Text": "Report"
    }
  ],
  "Status": "OK"
}

The response contains a list of cells (CellName) where the searched text was found, together with the worksheet name and the matching text. If no matches are found, the Cells array is empty and the request still returns HTTP 200 OK.

Error Codes

  • 400 Bad Request – Invalid Aspose.Cells Cloud API URI.
  • 401 Unauthorized – Invalid access token, client ID, or client secret.
  • 404 Not Found – The spreadsheet file is not accessible.
  • 500 Server Error – An unexpected condition prevented the API from completing the request.

Where should we use the Search content within the Spreadsheet API?

  • Comprehensive workbook compliance audit – Quickly scan the entire Excel file to identify all sensitive terms (e.g., “Confidential Clause”, “Internal Data”) for enterprise data‑security and compliance checks.
  • Cross‑sheet data association query – When project information is scattered across multiple worksheets, search for a specific project number or customer name and instantly locate all related data.
  • Batch template content verification – After automated report generation, scan multiple Excel files in batches to confirm that all preset placeholders (such as {{Date}}) have been correctly replaced, ensuring report completeness and accuracy.
  • Historical data archiving and mining – Analyse legacy files, search for specific event codes or business terms, and quickly understand historical business logic for data archaeology.

Why should you use the Search content within the Spreadsheet API?

  • Developer‑friendly – Aspose.Cells Cloud offers SDK libraries in multiple languages, enabling rapid development with comprehensive documentation. Compared with building custom solutions, this significantly reduces development effort.
  • Reduced labor costs – Automates repetitive search tasks, freeing developers from manual data‑extraction work.
  • Pay‑per‑use – No upfront investment; you only pay for the API calls you actually use.
  • No maintenance required – Aspose manages servers, updates, and compatibility, so you can focus on your application logic.
  • Preserves complex Excel formatting – Results can be exported to universally accessible PDF format while retaining original styling.

OpenAPI Specification

The OpenAPI Specification defines a publicly accessible programming interface and enables you to 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 search content within 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 illustrate how to invoke Aspose.Cells web services using various SDKs: