▣ OUTPUT KIT

Generate Book and Manuscript PDF API

What it does

Book Typesetter turns book manuscript data into a print-ready PDF, and also supports a Shunn standard-format manuscript PDF workflow.

Use the first endpoint when you need a finished book layout from structured content. Send a bookTitle, trim size (trimWidthIn, trimHeightIn), chapter list, and optional front matter, author metadata, publisher details, cover images, and back matter. The response is a binary PDF suitable for review or production. The schema supports chapter blocks such as paragraphs, headings, images, lists, tables, and scene breaks, plus book-level sections like praise, foreword, preface, dedication, epigraph, glossary, bibliography, endnotes, index, and answer key.

Use the second endpoint when you need a manuscript formatted to Shunn standard style. Send bookTitle, byline, authorLegalName, and chapter content. That endpoint returns a binary PDF with manuscript conventions applied for submission or editorial review.

Book Typesetter is a fit for publishing pipelines, self-publishing tools, editorial systems, and internal automation that need consistent book formatting without manual layout work. It gives you deterministic output from structured input, so you can generate readable drafts, production proofs, or submission copies from the same content model.

▣ ENDPOINT 01 / 02

POST

Typeset a print-ready book PDF (trim size, fonts, front and back matter)

https://api.eu.apyhub.com/freedailypro/generate-book-and-manuscript-pdf/typeset-book

QUICKSTART

GUIDE

Quickstart

Create a book layout and download the generated file.

curl -X POST "https://api.eu.apyhub.com/freedailypro/generate-book-and-manuscript-pdf/typeset-book" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bookTitle": "My First Book",
    "trimWidthIn": 5.5,
    "trimHeightIn": 8.5,
    "chapters": [
      {
        "title": "Chapter 1",
        "blocks": [
          {
            "type": "paragraph",
            "runs": [
              {
                "text": "Hello, world!"
              }
            ]
          }
        ]
      }
    ]
  }' \
  --output typeset-book-output.bin

What you'll get back

Returns a binary file (string with format: "binary"), not JSON. Save the response to a file with --output as shown above.

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

body*

chapters*

The chapters, in order, up to 100.

chapters-1*

title*

The chapter title, printed as the chapter heading and used in the table of contents.

blocks*

The chapter content in reading order, up to 800 blocks.

blocks-1*

blocks-0*

runs*

runs-1*

A piece of text with one style. A paragraph is a list of runs.

text*

The words of this run. Control characters that XML cannot hold are removed.

type*

bookTitle*

The book title: title page, cover, running header.

trimWidthIn*

Page width in inches (3 to 14), for example 5.5 for a 5.5 x 8.5 in book.

trimHeightIn*

Page height in inches (3 to 14).

isbn

Printed on the copyright page as given (not validated; use /v1/publishing/isbn to check it).

eisbn

Electronic ISBN, printed on the copyright page.

index

index-1*

index-0*

runs*

runs-1*

A piece of text with one style. A paragraph is a list of runs.

text*

The words of this run. Control characters that XML cannot hold are removed.

type*

foreword

blocks*

blocks-1*

blocks-0*

runs*

runs-1*

A piece of text with one style. A paragraph is a list of runs.

text*

The words of this run. Control characters that XML cannot hold are removed.

type*

authorName*

Who wrote the foreword; printed under it.

backCover

Adds a full-bleed back cover as the last page.

publisher

name*

frontCover

Adds a full-bleed front cover as the first page.

About this endpoint

What it does

Typesets a print-ready book PDF from a structured book manuscript. The request body defines the book metadata, front matter, chapters, back matter, trim size, font, layout options, and optional cover assets; the success response is a binary file.

Request Body

Parameter	Type	Mandatory	Description
bookTitle	String	Yes	The book title, printed on the title page, cover, and running header.
trimWidthIn	Number	Yes	Page width in inches, from 3 to 14.
trimHeightIn	Number	Yes	Page height in inches, from 3 to 14.
chapters	Object Array	Yes	The chapters in order, up to 100 items. Each chapter object requires `title` and `blocks`. `partTitle` is optional and groups adjacent chapters under the same part divider page.
chapters[].title	String	Yes	The chapter title, printed as the chapter heading and used in the table of contents.
chapters[].blocks	Object Array	Yes	Chapter content in reading order, up to 800 blocks. Each block must match one of the supported block shapes in the schema.
chapters[].partTitle	String	No	Groups this chapter and following chapters with the same value under a Part divider page.
isbn	String	No	Printed on the copyright page as given. Not validated.
eisbn	String	No	Electronic ISBN, printed on the copyright page.
index	Object Array	No	Index entries. Each item must match one of the supported index item shapes in the schema.
praise	Object Array	No	Front-matter praise entries, up to 800 items. Each item must match one of the supported content shapes in the schema.
authors	Object Array	No	Author entries, up to 50 items. Each author requires `name` and `role`. `bio` and `photoDataUri` are optional.
authors[].name	String	Yes	Author name, up to 200 characters.
authors[].role	ENUM	Yes	Author role. Allowed values: `main`, `contributing`, `illustrator`, `editor`.
authors[].bio	Object Array	No	Author bio content shown on the About the Author page, up to 800 items.
authors[].photoDataUri	String	No	Author photo as an image data URI.
edition	String	No	Edition label, such as `2nd Edition`, shown on the title page and covers.
preface	Object Array	No	Preface content, up to 800 items.
appendix	Object Array	No	Appendix content, up to 800 items.
endnotes	Object Array	No	Endnotes content, up to 800 items.
epigraph	Object Array	No	Epigraph content, up to 800 items.
foreword	Object	No	Foreword content. Requires `authorName` and `blocks`.
foreword.authorName	String	Yes	Name printed under the foreword.
foreword.blocks	Object Array	Yes	Foreword content blocks, up to 800 items.
glossary	Object Array	No	Glossary content, up to 800 items.
answerKey	Object Array	No	Answer key content, up to 800 items.
backCover	Object	No	Back cover configuration.
backCover.blurb	Object Array	No	Back-cover blurb content, up to 800 items.
backCover.imageDataUri	String	No	Full-bleed back-cover image as a data URI.
backCover.publisherName	String	No	Publisher name shown on the back cover.
backCover.qrCodeDataUri	String	No	QR code image data URI placed on the back cover.
backCover.barcodeDataUri	String	No	Barcode image data URI placed on the back cover.
backCover.publisherLogoDataUri	String	No	Publisher logo data URI placed on the back cover.
direction	ENUM	No	Reading direction. Allowed values: `auto`, `ltr`, `rtl`.
publisher	Object	No	Publisher details. Requires `name`; `intro` and `logoDataUri` are optional.
publisher.name	String	Yes	Publisher name.
publisher.intro	Object Array	No	Publisher intro content, up to 800 items.
publisher.logoDataUri	String	No	Publisher logo data URI.
watermark	Boolean	No	Opt-in preview watermark. Default is false.
dedication	Object Array	No	Dedication content, up to 800 items.
frontCover	Object	No	Front-cover configuration. `imageDataUri`, `publisherName`, and `publisherLogoDataUri` are optional.
frontCover.imageDataUri	String	No	Full-bleed front-cover image as a data URI.
frontCover.publisherName	String	No	Publisher name shown on the front cover.
frontCover.publisherLogoDataUri	String	No	Publisher logo data URI shown on the front cover.
includeToc	Boolean	No	Whether to include a table of contents.
seriesName	String	No	Series name, up to 300 characters.
authorsNote	Object Array	No	Authors' note content, up to 800 items.
gutterModel	ENUM	No	Margin model. Allowed values: `kdp-scaled`, `flat-0.5`, `flat-0.75-inside`.
alsoByAuthor	Object Array	No	Also-by-author content, up to 800 items.
bibliography	Object Array	No	Bibliography content, up to 800 items.
listOfGraphs	Object Array	No	List of graphs content, up to 800 items.
listOfTables	Object Array	No	List of tables content, up to 800 items.
titlePageContent	Object Array	No	Extra title-page content, up to 800 items.
copyrightYear	Integer	No	Copyright year. Minimum 1000, maximum 9999. Default is the current year.
bodyFontFamily	ENUM	No	Body font embedded in the PDF. Allowed values: `literata`, `eb-garamond`, `merriweather`, `lora`, `tinos`, `inter`, `arimo`, `playfair-display`. Default `literata`.
peerReviewNote	Object Array	No	Peer review note content, up to 800 items.
backMatterOrder	String Array	No	Order of back-matter sections. Allowed values: `acknowledgments`, `also-by-author`, `appendix`, `bibliography`, `endnotes`, `glossary`, `answer-key`, `index`.
copyrightHolder	String	No	Name printed after the copyright symbol.
frontMatterOrder	String Array	No	Order of front-matter sections. Allowed values: `praise`, `title-page`, `copyright-page`, `authors`, `dedication`, `epigraph`, `foreword`, `authors-note`, `preface`, `how-to-use`, `publisher`, `peer-review`, `toc`, `list-of-images`, `list-of-tables`, `list-of-graphs`. A section omitted from this list is left out.
howToUseThisBook	Object Array	No	How-to-use content, up to 800 items.
epigraphShowLabel	Boolean	No	Whether to show the epigraph label.
dedicationShowLabel	Boolean	No	Whether to show the dedication label.
includeListOfImages	Boolean	No	Whether to include a list of images.
copyrightPageContent	Object Array	No	Extra copyright-page content, up to 800 items.
epigraphImageDataUri	String	No	Image data URI used with the epigraph section.
titlePageImageDataUri	String	No	Image data URI used on the title page.
dedicationImageDataUri	String	No	Image data URI used with the dedication section.
copyrightPageImageDataUri	String	No	Image data URI used on the copyright page.

Response

Returns a binary file containing the generated PDF. The output schema is a single binary payload, so the success response is the downloadable document itself.

Parameter	Type	Mandatory	Description
file	Binary	Yes	The generated PDF binary.

Notes

watermark defaults to false, so the exported file is clean unless you opt in to the preview marking. Also note that bodyFontFamily is limited to the eight enumerated fonts, and unsupported scripts such as Chinese, Japanese, Korean, and other unsupported scripts are rejected with 422 unsupported_script according to the schema description.

▣ ENDPOINT 02 / 02

POST

Typeset a manuscript as a Shunn standard-format PDF

https://api.eu.apyhub.com/freedailypro/generate-book-and-manuscript-pdf/typeset-manuscript

QUICKSTART

GUIDE

Quickstart

Create a book manuscript from the required title, byline, author legal name, and at least one chapter.

curl -X POST "https://api.eu.apyhub.com/freedailypro/generate-book-and-manuscript-pdf/typeset-manuscript" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bookTitle": "The Hidden Orchard",
    "byline": "by Maria Lopez",
    "authorLegalName": "Maria Lopez",
    "chapters": [
      {
        "title": "Chapter 1",
        "blocks": [
          {
            "type": "paragraph",
            "runs": [
              {
                "text": "It was a quiet morning in the orchard."
              }
            ]
          }
        ]
      }
    ]
  }'

What you'll get back

Returns a binary file response. The output schema is a raw binary payload, so there is no JSON object to describe.

TRY ITLIVE · 30 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

body*

byline*

Written as it should appear after by, for example Maria Lopez.

chapters*

chapters-1*

title*

blocks*

blocks-1*

blocks-0*

runs*

runs-1*

A piece of text with one style. A paragraph is a list of runs.

text*

The words of this run. Control characters that XML cannot hold are removed.

type*

bookTitle*

Title, printed on the title page and in the running head (shortened, upper case).

authorLegalName*

Your legal name: top-left of the title page, the running-head surname, and the DOCX author property.

direction

Reading direction: auto (the default), ltr or rtl. With auto, a book whose text is mostly Arabic or Hebrew is laid out right to left and anything else left to right; ltr or rtl overrides that. Right to left means the first page is a left-hand page with the binding on its right, mirrored margins, text, lists, tables and the table of contents running from the right, correct mixing of English words and numbers inside Arabic or Hebrew lines, and a PDF marked right-to-left (page 1 on the right of the spine in two-page view). EPUB: every page is dir=rtl and the spine has page-progression-direction=rtl. DOCX: right-to-left paragraphs and sections, Arabic and Hebrew runs marked right-to-left.

Opt-in preview watermark. Default false: the file is clean, with no promotional text. true adds a visible PREVIEW marking: in the PDF a light diagonal PREVIEW tiled across every page, in the EPUB and DOCX a banner line reading PREVIEW COPY on the cover and every chapter (EPUB) or in the page header (DOCX). The X-Watermark response header says whether it was applied.

watermark

authorEmail

About this endpoint

What it does

Typesets a manuscript into a Shunn standard-format PDF. You send the book metadata and chapter content in the request body, and the endpoint returns the generated file as binary data.

Request Body

Parameter	Type	Mandatory	Description
bookTitle	String	Yes	Title, printed on the title page and in the running head (shortened, upper case).
byline	String	Yes	Written as it should appear after `by`, for example Maria Lopez.
authorLegalName	String	Yes	Your legal name: top-left of the title page, the running-head surname, and the DOCX author property.
authorEmail	String	No
authorPhone	String	No
authorAddress	String	No
direction	ENUM	No	Reading direction. Allowed values: `auto` (default), `ltr`, `rtl`. `auto` lays out right-to-left only when the book is mostly Arabic or Hebrew.
watermark	Boolean	No	Opt-in preview watermark. Default `false`. `true` adds a visible PREVIEW marking.
chapters	Object Array	Yes	Chapter entries. Each chapter must include `title` and `blocks`.
chapters[].title	String	Yes	Chapter title. Maximum length 300 characters.
chapters[].partTitle	String	No	Part title. Maximum length 300 characters.
chapters[].blocks	Object Array	Yes	Content blocks for the chapter. Allowed block types: paragraph, heading, image, list, table, sceneBreak.
chapters[].blocks[].type	ENUM	Yes	Allowed values depend on the block object: `paragraph`, `heading`, `image`, `list`, `table`, or `sceneBreak`.
chapters[].blocks[].runs	Object Array	Yes (if `type` is `paragraph` or `heading`)	Text runs for a paragraph or heading. Each run must include `text`.
chapters[].blocks[].runs[].text	String	Yes	The words of this run. Control characters that XML cannot hold are removed.
chapters[].blocks[].runs[].bold	Boolean	No
chapters[].blocks[].runs[].color	String	No	Text colour as a hex code matching `^#[0-9a-fA-F]{3,8}$`.
chapters[].blocks[].runs[].italic	Boolean	No
chapters[].blocks[].runs[].subscript	Boolean	No
chapters[].blocks[].runs[].underline	Boolean	No
chapters[].blocks[].runs[].superscript	Boolean	No
chapters[].blocks[].align	ENUM	No	Allowed values: `left`, `center`, `right`, `justify`.
chapters[].blocks[].lineHeight	String	No	Line height as a multiplier written as text, matching `^[0-9](\\.[0-9]+)?$`, for example `1.5`.
chapters[].blocks[].level	ENUM	Yes (if `type` is `heading`)	Heading level. Allowed values: `1`, `2`, `3`, `4`. Level 1 is shown as a sub-heading inside a chapter.
chapters[].blocks[].dataUri	String	Yes (if `type` is `image`)	Base64 data URI for the image. Allowed types: `image/jpeg`, `image/png`, `image/gif`, `image/webp`, `image/svg+xml`. Maximum length 15,000,000 characters.
chapters[].blocks[].alt	String	No	Alternative text for screen readers. Maximum length 500 characters.
chapters[].blocks[].caption	String	No	Caption shown under the picture. Maximum length 500 characters.
chapters[].blocks[].widthFrac	Number	No	Picture width as a fraction of the text width, from `0.1` to `1`. Default `1`.
chapters[].blocks[].ordered	Boolean	Yes (if `type` is `list`)	`true` for a numbered list, `false` for bullets.
chapters[].blocks[].items	Object Array	Yes (if `type` is `list`)	List items. Each item is a list of runs.
chapters[].blocks[].items[].text	String	Yes	The words of this run. Control characters that XML cannot hold are removed.
chapters[].blocks[].items[].bold	Boolean	No
chapters[].blocks[].items[].color	String	No	Text colour as a hex code matching `^#[0-9a-fA-F]{3,8}$`.
chapters[].blocks[].items[].italic	Boolean	No
chapters[].blocks[].items[].subscript	Boolean	No
chapters[].blocks[].items[].underline	Boolean	No
chapters[].blocks[].items[].superscript	Boolean	No
chapters[].blocks[].rows	Object Array	Yes (if `type` is `table`)	Table rows. Short rows are padded to the widest row.
chapters[].blocks[].rows[].cells	Object Array	Yes	Table cells for the row. Each cell is a list of runs.
chapters[].blocks[].rows[].header	Boolean	No	`true` makes this a header row; in DOCX it is bold and repeats on each page.
chapters[].blocks[].rows[].cells[].text	String	Yes	The words of this run. Control characters that XML cannot hold are removed.
chapters[].blocks[].rows[].cells[].bold	Boolean	No
chapters[].blocks[].rows[].cells[].color	String	No	Text colour as a hex code matching `^#[0-9a-fA-F]{3,8}$`.
chapters[].blocks[].rows[].cells[].italic	Boolean	No
chapters[].blocks[].rows[].cells[].subscript	Boolean	No
chapters[].blocks[].rows[].cells[].underline	Boolean	No
chapters[].blocks[].rows[].cells[].superscript	Boolean	No

Response

Returns a binary file containing the generated PDF. The output schema is a single binary string, so the success response is the downloadable document itself.

Parameter	Type	Mandatory	Description
binary	String	Yes	Binary PDF file returned by the endpoint.

Notes

Image inputs must be provided as data URIs, not web URLs. The schema explicitly says web addresses are never fetched, and image bytes are decoded and checked; a wrong MIME label or damaged image is rejected.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLGenerate Letter Document from JSON APICallable Labs CALLGenerate Report Document from JSON APICallable Labs CALLImage & PDF OCR to Markdown APICallable Labs CALLAdvanced Webpage to PDF APIWebsite Intelligence

From the blog

Reads that touch this API.

The Ultimate Guide to PDF Editing and Conversion Tools for Developers in 2025Jul 9, 2026 PDF Automation API Guide 2026: Generate, Merge, Watermark and Extract PDFsSep 22, 2026 Generate Fast and Lightweight File Previews for docs, PDFs, DOCX, PPTX and more.Jul 9, 2026 PDF to Markdown with Python: A Resumable OCR Pipeline for RAGOct 25, 2026