NVP API

Example

<form method='post' action='http://runpdf.com/export' >

    <input type='hidden' name="EXPORT_KEY" value='enter your export key here' />

    URL: <input type='text' name="SOURCE_URL" value='http://amazon.com' /><br/>

    Live HTTP links: <input type='text' name="LIVE_LINKS" value='Y' /><br />

    Avoid image break: <input type='text' name="NO_IMG_BRAKE" value='Y' /><br />

    Page Format: <input type='text' name="FORMAT" value='A4' /><br />

    Page Orientation: <input type='text' name="ORIENTATION" value='P' /><br />

    Standard: <input type='text' name="STANDARD" value='P' /><br />

    PDF Delivery Inline: <input type='text' name="GET_DOCUMENT_INLINE" value='N' /><br />

    <input type='submit' name='Submit' value='Submit' />

</form>
Visit our Demo pages and see more sample code

Endpoint

URL Description
http://runpdf.com/export
Required
The physical address of the RunPDF Export web service.

Behavior

Field Description
DELAY
Optional
Delay of the conversion in seconds to wait for JavaScript to complete after page load.
A number between 0 and 60. Default is 2.

Request Authentication

Field Description
EXPORT_KEY
Required
All accounts are assigned a unique export key. The key is available in the signup confirmation email and the Order Detail page.

Source

Field Description
SOURCE_URL
Required*
URI of a web page to convert.
*Note: Ether SOURCE_URL or SOURCE_HTML is required to be submitted for conversion. URI with special characters must be encoded.
SOURCE_HTML
Required*
HTML code to convert.
*Note: Ether SOURCE_URL or SOURCE_HTML is required to be submitted for conversion. HTML string must be encoded.
SOURCE_BASE_URL
Optional
In case of HTML code to convert, it helps to get the CSS files and images referenced by a relative URL in the HTML string.
Note: URI with special characters must be encoded.
SOURCE_URL2
Optional
URI of a second web page to convert. If present, the content of the two web pages will be merged into one PDF.
Note: URI with special characters must be encoded.

Title And Delivery

Field Description
TITLE
Optional
Sets the name of the generated pdf file. If value is not set the page Url is used instead.
GET_DOCUMENT_INLINE
Optional
Sets the document delivery method as an inline. If not set, the document will be delivered as an attachment. The values are:
Y = yes
N = no (default)

Appearance

Field Description
MEDIA_TYPE_PRINT
Optional
Sets if to present the document on print media style. The values are:
Y = yes
N = no (default)
SINGLE_PAGE
Optional
Sets if to render the whole HTML content into a single PDF page. The values are:
Y = yes
N = no (default)
LIVE_LINKS
Optional
Sets if to enable URLs on the document. The values are:
Y = yes (default)
N = no
NO_IMG_BRAKE
Optional
Sets if to avoid image break between pages. The values are:
Y = yes
N = no (default)
FORMAT
Optional
Sets the format of the document pages. The values are:
A0, A1, A2, A3, A4 (default), A5, A6, A7, A8, A9, A10, B0, B1, B2, B3, B4, B5, ArchA, ArchB, ArchC, ArchD, ArchE, Flsa, HalfLetter, Ledger, Legal, Letter, Letter11x17, Note
ORIENTATION
Optional
Sets the orientation of the document pages. The values are:
P = portrait (default)
L = landscape
STANDARD
Optional
Sets the PDF standard. The values are:
P = PDF (default)
A = PDF/A
X = PDF/X
NEW_DOC_NEW_PAGE
Optional
Sets if to start second URL conversion on a new PDF page. The values are:
Y = yes
N = no (default)

NTLM Authentication

Field Description
Note: Only NTLM authentication is supported.
AUTH_USERNAME
Optional*
Sets NTML authentication username.
*Note: If present, AUTH_PASSWORD is required.
AUTH_PASSWORD
Optional*
Sets NTML authentication password.
*Note: If present, AUTH_USERNAME is required.

Security And Permissions

Field Description
SEC_OWNER_PASSWORD
Optional
Sets a protected document with the owner password. The owner will have all the rights.
Note: The max length is 8 characters. Special characters are not allowed.
SEC_USER_PASSWORD
Optional
Sets a protected document with the user password.
Note: The max length is 8 characters. Special characters are not allowed.
SEC_ALLOW_PRINT
Optional
Sets if to allow the user to print the document. The values are:
Y = yes (default)
N = no
SEC_ALLOW_COPY
Optional
Sets if to allow the user to copy the contents of the document. The values are:
Y = yes (default)
N = no
SEC_ALLOW_EDIT
Optional
Sets if to allow the user to edit the contents of the document. The values are:
Y = yes (default)
N = no
SEC_ALLOW_FILL_FORM_FIELDS
Optional
Sets if to allow the user to fill form fields of the document. The values are:
Y = yes (default)
N = no

Header And Footer

Field Description
HEADER_SOURCE_URL
Optional
URI of a web page to use as the header.
Note: URI with special characters must be encoded.
FOOTER_SOURCE_URL
Optional
URI of a web page to use as the footer.
Note: URI with special characters must be encoded.
HEADER_SOURCE_HTML
Optional
Sets HTML string to use as the header. Note: HTML string must be encoded.
FOOTER_SOURCE_HTML
Optional
Sets HTML string to use as the footer. Note: HTML string must be encoded.
HEADER_HEIGHT
Optional
Sets the height of the header in pixels.
FOOTER_HEIGHT
Optional
Sets the height of the footer in pixels.
FOOTER_SHOW_PAGE_NUMS
Optional
Sets if to show page numbers on the footer. The values are:
Y = yes
N = no (default)

Watermark

Field Description
WM_IMAGE_URL
Optional
URI to an image to show as the watarmark.
Note: URI with special characters must be encoded.
          PNG format only.
WM_TEXT
Optional
Text to show as the watarmark.
WM_OPACITY
Optional
Opacity of the watarmark.
A number between 0 and 100. Default is 50.
WM_TEXT_POSITION
Optional
Position of the watarmark text. The values are:
horizontal (default)
diagonal
WM_TEXT_COLOR
Optional
Color of the watarmark text.
A valid name of the color. Default is Gray.
WM_TEXT_FONT_SIZE
Optional
Size of the font of the watarmark text.
A number between 0 and 100. Default is 20.