Skip to product menu

Zoho Analytics has been recognized in the 2025 Gartner® Magic Quadrant™ for ABI Platforms.Read more

Skip to main content

Using SQL Query

Create an export job using SQL select statement to initiate data export.

REQUEST URI

https://<ZohoAnalytics_Server_URI>/restapi/v2/bulk/workspaces/<workspace-id>/data

Get

oauthscope

QUERY PARAMETERS

 

Parameter Name
Description
CONFIG*JSONObject
Config parameter specifications are available in the below section.

FIELDS FOR CONFIG JSON

KeyDescription
sqlQuery*String

SQL SELECT Query.
Using SQL Select statements data can be exported from a single Table/Query Table or joining one or more tables.
Check here for more details.
responseFormat*

String

The format of the data to be exported.

  • csv
  • json
  • xml
  • xls
  • pdf
  • html
selectedColumnsJSONArray

Controls the columns that need to be exported.

showHiddenColsBoolean

Controls whether the columns that have been hidden in the table have to be exported.
Default value - false.
showPersonalColsBoolean

Controls whether the columns that have been marked as personal data in the table have to be exported.
Default value - false.
callbackUrlString

A valid URL, that should allow HTTP Post method.
The Bulk Export Job's details is posted to this URL on successful completion of job or on failure of job.

CSV SPECIFIC ATTRIBUTES

KeyDescription
delimiter

Integer

The delimiter character used for separating the fields in a row in the CSV.

  • 0 - COMMA
  • 1 - TAB
  • 2 - SEMICOLON
  • 3 - SPACE
recordDelimiter

Integer

The record delimiter (newline character) to use.

  • 0 - DOS
  • 1 - UNIX
  • 2 - MAC
quoted

Integer

The quote character to use for quoting the values.

  • 0 - SINGLE
  • 1 - DOUBLE
includeHeaderBoolean

To include the column names in the first row of the CSV exported.
Default value - true.

JSON SPECIFIC ATTRIBUTES

KeyDescription
keyValueFormatBoolean

To return JSON data as ColumnName - Value pair.
Default value - true.

PDF SPECIFIC ATTRIBUTES

KeyDescription
paperSize

Integer

The size of the paper.

  • 0 - LETTER
  • 1 - LEGAL
  • 2 - TABLOID
  • 3 - A3
  • 4 - A4
  • 5 - AUTO
paperStyleString

To controls the orientation.
Portrait/Landscape
showTitle

Integer

To controls the title positioning.

  • 0 - AT TOP
  • 1 - AT BOTTOM
  • 2 - NONE
showDesc

Integer

To controls the description positioning.

  • 0 - AT TOP
  • 1 - AT BOTTOM
  • 2 - NONE
exportLanguage

Integer

PDF will be rendered using the specified language.

  • 0 - ENGLISH
  • 1 - CHINESE
  • 2 - JAPANESE
  • 3 - EUROPEAN
  • 4 - KOREAN


Default value - 0 (ENGLISH).

zoomFactorInteger

To control the zoom factor for the PDF.
Between 0 to 100
Default value - 100.
Margin Settings:
topMargin
bottomMargin
leftMargin
rightMargin
Decimal values between 0 to 1The margin in inches for that edge. Can be decimal between 0 to 1 (like 0.5).
 
Header/Footer Settings:
leftHeader
rightHeader
centerHeader
leftFooter
rightFooter
centerFooter

Integer

The header or footer value that needs to be generated for each page at that particular position.

  • 0 - Leave it blank
  • 1 - Include Title
  • 2 - Current Date/Time
  • 3 - Include Page number in the format “Page #”
  • 4 - Include page number in the format “Page # Of #”
  • 5 - CUSTOM - Include custom text in footer
Custom Header/Footer value
leftHeaderText
rightHeaderText
centerHeaderText
leftFooterText
rightFooterText
centerFooterText
String

If any of the header/footer setting is 5 (.ie, CUSTOM) then the corresponding custom value/text should be passed.

HTML SPECIFIC ATTRIBUTES

KeyDescription
includeTitle

Integer

To contol the title positioning.
Default value - 0.

  • 0 - AT TOP
  • 1 - AT BOTTOM
  • 2 - NONE
includeDesc

Integer

To contol the description positioning.
Default value - 0.

  • 0 - AT TOP
  • 1 - AT BOTTOM
  • 2 - NONE

POSSIBLE ERROR CODES

7103 , 7403 , 8002 , 8046 , 8119 , 8504

Sample Request:

Copied
Copied
Copied
Copied
Copied
Copied
Copied
Copied

Download client libraries:  C# | GO | JAVA | PHP | PYTHON | NodeJS

Sample value for CONFIG parameter:

Copied

Sample Request:

Copied
 
 
Thanks for your interest. We shall get back to you shortly.