Convert Worksheet to PDF, PNG, CSV & More – Aspose.Cells Cloud API

Worksheet conversion API – The GET /cells/{name}/worksheets/{sheetName} endpoint converts a single worksheet (a sheet inside an Excel workbook) to another file type.

Supported importable formats (the worksheet can be read from):

  • XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT

Supported export‑only formats (the worksheet can be saved as):

  • PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS

REST API

The OpenAPI Specification describes the publicly accessible interface.

Prerequisites & Authentication

  • Obtain a JWT token from the Aspose Cloud authentication service.
  • Include the token in the request header:
-H "Authorization: Bearer <jwt token>"
  • The API version used in the examples is v3.0.

Parameters

Parameter Type Required Default Allowed Values Description
format string Yes – pdf, png, jpeg, bmp, svg, tiff, emf, csv, txt, … (see supported list) Target output format.
verticalResolution integer No 96 72‑600 Vertical DPI for image output.
horizontalResolution integer No 96 72‑600 Horizontal DPI for image output.
password string No – – Password for opening a protected workbook.
folder string No – – Cloud folder where the source workbook is stored.
storage string No – – Name of the storage (e.g., “Default”).

Response

Status Code Description Return Type
200 Conversion succeeded; binary stream of the converted file is returned. application/octet-stream
400 Bad request – missing or invalid parameters. JSON error object
401 Unauthorized – invalid or missing JWT token. JSON error object
404 Not found – workbook or worksheet does not exist. JSON error object
500 Internal server error – unexpected failure. JSON error object

Example Request (cURL)

curl -v "https://api.aspose.com/v3.0/cells/myWorkbook.xlsx/worksheets/Sheet1?format=png&verticalResolution=96&horizontalResolution=96" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Example Response

Converted Image (binary stream)

Cloud SDK Family

Using an SDK is the fastest way to develop. An SDK handles low‑level details so you can focus on your project. Please check 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:

Frequently Asked Questions

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What HTTP method is used to convert a worksheet with Aspose.Cells Cloud?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The endpoint uses the **GET** method on `/cells/{name}/worksheets/{sheetName}` with the `format` query parameter specifying the desired output type."
      }
    },
    {
      "@type": "Question",
      "name": "Which image formats can a worksheet be exported to?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The API supports PNG, JPEG, BMP, SVG, TIFF, and EMF for image export."
      }
    },
    {
      "@type": "Question",
      "name": "How do I authenticate the request to the worksheet conversion endpoint?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Include an `Authorization: Bearer <jwt token>` header obtained from the Aspose Cloud authentication service."
      }
    }
  ]
}
Export a Worksheet with Aspose.Cells Cloud API – Formats, cURL & SDK Samples Export a Worksheet Area to PNG, PDF, CSV – Aspose.Cells Cloud API