Skip to main content
POST
Convert Webpage URL to PDF

Request contract

  • Method and path: POST /apis/v1/pdf-co/pdf-from-url
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/pdf-co/pdf-from-url
  • Runtime facts: 2a3bd567205aeb00d10d4a6e8fbb280d098e3912e71bc16c07b9f91f82195a26
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0103 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0103
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 10000000
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string
required

Public webpage URL to convert to PDF.

name
string

File name for the generated PDF.

HTML inserted in the footer of every output page.

header
string

HTML inserted in the header of every output page.

margins
string

Page margins as one value or as top, right, bottom, and left values using px, mm, cm, or in units.

profiles
string

Advanced PDF.co conversion settings as a JSON-formatted string.

mediaType
enum<string>

CSS media type used to render the webpage.

Available options:
print,
screen,
none
paperSize
string

Standard paper size such as Letter or A4, or a custom width and height such as '200mm 300mm'.

expiration
integer

Number of minutes before the temporary output link expires.

orientation
enum<string>

Portrait or landscape page orientation.

Available options:
Portrait,
Landscape
renderTimeout
integer

Maximum webpage rendering time in milliseconds, up to 177000.

Required range: x <= 177000
legacyRendition
boolean

Whether to render with PDF.co's legacy Chromium version.

printBackground
boolean

Whether to include webpage background colors and images.

DoNotWaitFullLoad
boolean

Whether to begin conversion after minimal loading instead of waiting for the full page load.

Response

Tool result data

error
boolean
required
status
required
url
string
name
string
credits
integer
duration
integer
pageCount
integer
remainingCredits
integer