PrintFriendly

REST API

PrintFriendly for Make

Turn web pages into clean PDF, Word or Markdown inside your Make scenarios. Save every new feed item as a PDF in Google Drive, turn a list of links into Word files, or hand a page to an AI module as clean Markdown. You need a PrintFriendly API key and a Make account.

Connect Your Account

  1. Sign in to PrintFriendly and open your API key page. Copy your key. A free key includes 100 documents a month and needs no credit card.
  2. In Make, open a scenario, add a module, and search for PrintFriendly. Pick Convert to a document.
  3. Under Connection, create a connection, paste your key into API key, and save.

Make checks the key when you save the connection. That check never uses one of your documents. Every PrintFriendly module in your scenarios can share the one connection.

What It Does

PrintFriendly adds four modules to Make.

Convert to a document

Pick a Source type (Web page URL, HTML or Markdown), give it the page address or the markup, and choose an Output format. PrintFriendly keeps the article and leaves out the ads, menus and pop-ups.

  • PDF or Word document (DOCX): you get a File URL. Add a Download a file module after it to turn that link into a file the next module can upload or attach.
  • Markdown, HTML page or Plain text: text the next module can use, in Content.
  • JSON: the article in pieces under Document (title, author, date, text), for modules that want one field at a time.

Select Show advanced settings for the rest: a title, the page size (Letter or A4), a line of header text, a header image, your own CSS, the language and text direction, and whether to keep link addresses in text output.

Download a file

Takes a File URL from Convert to a document or Get a job and gives you the file itself, as File name and Data. Those are the two things a Google Drive, Dropbox or email module asks for when it takes a file. You can set your own File name, such as report.pdf; left empty, the name in the link is used.

Get a job

Convert to a document has a Run in the background option for very long pages: the module finishes right away with a Job ID, and the document is made on its own. Get a job looks one up by its Job ID and, once it is done, gives you the File URL or the text. Jobs are kept for 48 hours, and only the API key that started a job can read it.

Make an API call

For anything the other modules do not cover. Give it a path on the PrintFriendly API and it sends the request with your key already attached. For example, /v2/usage tells you how many documents you have used this month, and never uses one.

Dates work with Make's date tools

Expires at, Created at and Finished at come through as dates, so you can format them, compare them or filter on them with Make's own date functions.

Example Scenarios

Save new feed items as PDFs in Google Drive

  1. RSS, Watch RSS feed items. Paste the address of the blog's feed.
  2. PrintFriendly, Convert to a document. Source type: Web page URL. Map the item's URL to Web page URL. Output format: PDF.
  3. PrintFriendly, Download a file. Map File URL from the Convert module.
  4. Google Drive, Upload a file. Choose the PrintFriendly file as the source, and pick a folder.

Turn Markdown into a Word file

  1. Any module that gives you Markdown, such as a note or a draft.
  2. PrintFriendly, Convert to a document. Source type: Markdown. Map the text to Markdown. Output format: Word document (DOCX).
  3. PrintFriendly, Download a file, then any module that takes a file.

Read a page as Markdown for a summary

  1. Any module that gives you a web page address.
  2. PrintFriendly, Convert to a document. Source type: Web page URL. Output format: Markdown.
  3. An AI module, or your own step, using Content.

Convert a very long page in the background

Most pages do not need this. Use it when a page is so long that the module runs out of time.

  1. Any module that gives you a web page address.
  2. PrintFriendly, Convert to a document, with Run in the background turned on. It returns a Job ID.
  3. Tools, Sleep. A minute or so is enough for most documents.
  4. PrintFriendly, Get a job. Map Job ID from the Convert module.
  5. PrintFriendly, Download a file. Map File URL from the Result of Get a job.

Common Questions

Make says PrintFriendly did not accept the API key (401)#

The key is wrong, or it was replaced with a new one. Copy your key again from your API key page, then update the PrintFriendly connection in Make with it.

A module stopped with a 402 error#

Your key has used all of its documents for now. A free key includes 100 documents a month, and the count starts again on the 1st. On a paid plan, you can turn on extra documents or raise your monthly cap on your API key page. Plans are on the API pricing page.

A module says it was rate limited (429)#

Too many documents were asked for at once. Free keys can make 10 requests a minute and paid keys 120. Add a Sleep module to spread the work out, or move to a paid plan.

Download a file says the file is no longer available#

File URLs last 48 hours. Download the file in the same scenario run that made it, and save it somewhere of your own, such as Google Drive. To get an old one back, convert the page again.

The next module has no file to upload#

Convert to a document gives you a link, not the file. Put a Download a file module between it and the module that needs the file, and map File URL into it.

The PDF is empty, or part of the page is missing#

PrintFriendly reads the public version of a page. A page behind a login or a paywall, or on a site that blocks automated visitors, can come back empty or partial. If an earlier module already has the page's HTML, set Source type to HTML and map it in.

Get a job stops with a 404 error#

Get a job only finds jobs from the last 48 hours that were started with the same API key. Check that Job ID is mapped from the Convert module.

What uses one of my documents?#

Each Convert to a document that works uses one document from your plan. One that fails does not. A background job counts when it runs, not when it starts. Connecting your account, Download a file and Get a job never use a document.

Can I do this without Make?#

Yes. The REST API uses the same key and the same plan. There is also a Zapier app, an n8n node and a LangChain loader for Python.

For your key, your documents, or a page that comes out wrong, contact PrintFriendly support.