Convert anything to EPUB

The API for converting any file to EPUB.

Here you can see all available conversion options which you can use within the "options" section of conversions (see the example JSON below the table).

Here you can see all available conversion options which you can use within the "options" section of conversions (see the example JSON on the right).

Option Name	Description
allow_multiple_outputs Type: boolean Default: False	If the conversion produces more than one output file, by default all of them are compressed in just one file. Set this option to true if you want a download link for each file.
allow_multiple_outputs_threshold Type: integer Minimum: 2 Maximum: 400	Sets the threshold for the number of output files during conversion. This option is considered only when `allow_multiple_outputs` is set to true. If the generated output files exceed this threshold, they are compressed into one file. Conversely, if the threshold is not met, each output file remains uncompressed.
ascii Type: boolean Default: False	ASCII output
author Type: string Pattern: ^[\w\W]{0,512}$	Change ebook author (up to 512 characters)
base_font_size Type: integer Minimum: 6 Maximum: 22	Force a specific base font size in pts. All of the other fonts will be scaled proportionally to this value.
border Type: integer Minimum: False Maximum: 20	Add border in centimeters
download_password Type: string Pattern: ^[ -~]{0,1000}$ Example: secret_password	A password to protect the download. To download the file send the password in the x-oc-download-password header or set a cookie named x-oc-download-password. The value contains a comma separated list of passwords.
embed_font Type: string Enum: sans serif	Embed generic font
enable_heuristics Type: boolean Default: False	Enable heuristic processing
encoding Type: string Enum: ascii cp1250 cp1251 cp1252 cp1253 cp1254 cp1257 iso8859_1 iso8859_2 iso8859_4 iso8859_5 iso8859_7 iso8859_9 iso8859_13 iso8859_15 koi8_r utf8 utf-16 euc_jp sjis iso2022jp gbk iscii91 big5 tis620 gb2312 ISO-2022-KR	Change the input encoding
language_stt Type: string Enum: ar-AR ca-ES zh-CN cs-CZ de-DE el-GR en-IN en-US es-ES fa-IR fr-FR hi-IN it-IT ja-JP kk-KZ nl-NL pl-PL pt-FB sv-SE ru-RU tl-PH tr-TR uk-UA vi-VN	Language of the audio source
output_filename Type: string Pattern: ^[\w\W]{0,255}$ Example: my_base_filename_without_extension	The desired file name of the converted file WITHOUT the file extension.
preset Type: string Pattern: ^[\w\W]{1,255}$	Predefined options
reader Type: string Enum: default Apple iPad Apple iPad 3 Cybook 3 Cybook Opus Ectaco jetBook Galaxy Generic e-ink Generic HD e-ink Generic large e-ink Hanlin V3 Hanlin V5 iLiad IrexDR800 IrexDR1000 jetBook Kobo Mobipocket MS Reader Nook Nook Color Nook HD Plus Pocketbook 900 Pocketbook Pro 912 Pocketbook InkPad 3 Pocketbook InkPad Lux Pocketbook InkPad HD Sony Sony 300 Sony 900 Sony Landscape Sony T3 Tablet	Choose a target ebook reader for better compatibilty
title Type: string Pattern: ^[\w\W]{0,512}$	Change ebook title (up to 512 characters)
version Type: string Enum: 2 3	The format's version

Output Example

POST /v2/jobs HTTP/1.1
Host: https://api.api2convert.com
X-Oc-Api-Key: <your API key here>
Content-Type: application/json
{
    "input": [{
        "type": "remote",
        "source": "https://example-files.online-convert.com/document/pdf/example.pdf"
    }],
    "conversion": [{
        "category": "ebook",
        "target": "epub",
        "options": {
            <conversion options here>
        }
    }]
}