Find Text in Excel Files – Aspose.Cells Cloud API

This REST API searches for text within Excel files.

REST API

POST https://api.aspose.cloud/v3.0/cells/search

Security and Authentication

The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.

Request parameters

Parameter Name	Type	Location	Description
file	file	formData (multipart)	The spreadsheet file to upload.
text	string	query string	The text string to search for.
password	string	query string (optional)	Password for opening a protected workbook, if required.
sheetname	string	query string (optional)	Name of the worksheet to limit the search to a specific sheet.

Response

{
  "Status":"OK",
  "Code":200,
  "TextItems": {
    "link": {
      "Href": "string",
      "Rel": "string",
      "Title": "string",
      "Type": "string"
    },
    "TextItemList": [
      {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "Text": "string"
      }
    ]
  }
}

Http Status Codes

Code	Meaning	Description
200	OK	Compression succeeded; response contains compressed file details.
400	Bad Request	Missing or invalid parameters (e.g., unsupported file type).
401	Unauthorized	Invalid or missing JWT token.
413	Payload Too Large	Uploaded file exceeds size limit.
500	Internal Server Error	Unexpected server error.

How to Use the PostSearch API with SDKs

PostSearch API Specification

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

You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows how to make calls to the Cloud API with cURL. Make sure you replace <jwt token> with a valid JWT token that has the required scope for the Cells API.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/search?text=1" \
  -X POST \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F "file=@book1.xlsx"

Response

[
  {
    "Text": "12/31/1899 10:10:00 AM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 11:10:00 AM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 12:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 1:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 2:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 3:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 4:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 5:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 6:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 7:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 8:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 9:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 10:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "12/31/1899 11:10:00 PM",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet5",
      "Rel": "parent"
    }
  },
  {
    "Text": "18",
    "link": {
      "Href": "Book1.xlsx/worksheets/Sheet7",
      "Rel": "parent"
    }
  }
]

Use Aspose.Cells Cloud SDKs

Using an SDK is the most efficient way to accelerate development. An SDK abstracts low‑level details, allowing you to focus on your business logic. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

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

Find text in an Excel worksheet Replace text in an Excel workbook