PDF.co platform helps to easily automate adding text, images, signatures to existing PDF files or PDF templates.

When you need to add your signature, company logo, graph, pictures, or stamp a status such as PAID to a document, the PDF Editor Web API’s Add Image (or Stamp) to PDF do it all.

Here are the things that the Web API can do:

  • Resize and add the image anywhere in the PDF.
  • Specify the page, pages, and page range you want to add the image so there’s no need to split the PDF.
  • Make the image clickable. You can redirect it to any URL.
  • Works with PDFs that require HTTP auth username and password.
  • Supports image formats such as JPG, PNG, BMP, and TIFF.


The PDF output files generated by the Web API are set to expire after an hour by default. The temporary URLs are also stored in random names for added security. You can configure your workflow to delete the files after use if you prefer to remove them right away. To learn more about PDF.co Security, please check out our Security page here.

PDF Editor Web API Benefits

Ease of Use

The PDF Editor Web API is very straightforward to use. You only need to fill your data in the parameters, run it and instantaneously get the result. We have templates, sample code snippets in various programming languages, and tutorials to guide you in using the Web API.

Add Images to PDF

You can add JPG, PNG images on top of the PDF file. You can also add semi-transparent PNG and GIF files and use base64 encoded (Datauri) URLs with embedded images.

Add Image Anywhere

You can set the coordinates where you want to add your image or stamp to the document. Our PDF Viewer tool can help you find the coordinates. You can access it in the Helper Tools inside your PDF.co account.

Large File Support

The Web API supports asynchronous file processing. This allows the engine to do the job in the background. This will return a Job ID and check the job status later on.

Speed and Security

You can use PDF files located in your Dropbox, Google Drive and you can also use built-in PDF.co Files Storage to store PDF files, images, signatures for re-use with the PDF.co platform.


You can use the PDF.co platform via integration on automation platforms like Zapier and IntegromatUiPath, and BluePrism. You can easily connect with the most popular applications through our 300+ API integrations.

On-Premise API Server

The PDF Editor Web API is one of the PDF.co modules that you can use on-premise. We highly recommend the on-premise API Server to organizations with high volumes. You can pick and choose specific modules that you want to use. To give it a spin, please contact our support team.

Enterprise Solutions

For enterprise customers, there is a Dedicated API Server that runs as a dedicated private server with dedicated private cloud storage in the hosting region of your choice.



PDF Editor Web API Integrations

PDF.co has over 300+ app integration. Kindly explore our following plugins:

PDF Editor Web API Samples & Demo

In this demonstration, we will add the ByteScout logo in a PDF Invoice. We will place it in the center of the document. You can add images and stamps using the /v1/pdf/edit/add endpoint.

Add Images Web API Input And Output PDFs
PDF Editor Web API Input And Output PDFs

Let’s go over the /v1/pdf/edit/add endpoint’s parameters.


URL: https://api.pdf.co/v1/pdf/edit/add
Method: POST
Parameter Description
url required. URL to the source PDF file.
images[] Array of image urls (also can be a link to Files storage or datauri link) to be added on top of PDF file. Images can be loaded from URL or from URLs for internal file storage.
url – url to image as http link, filetoken or datauri:.. url (with base64 encoded image).
x – x coordinate
y – y coordinate
width – width of the image
height – height of the image
pages – comma-separated indices of pages (or page ranges) that you want to use.
link – link to open on click
encrypt optional. Enable encryption for the output file. Must be one true or false.
async optional. Runs processing asynchronously.
name optional. name of the output file.
profiles optional. Must be a String. Set custom configuration. See profiles examples here


cURL Code Snippet

curl --location --request POST 'https://api.pdf.co/v1/pdf/edit/add' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data-raw '{
    "async": false,
    "encrypt": true,
    "name": "newDocument",
    "url": "https://bytescout-com.s3-us-west-2.amazonaws.com/files/demo-files/cloud-api/pdf-edit/sample.pdf",
    "images": [
            "url": "https://bytescout-com.s3-us-west-2.amazonaws.com/files/demo-files/cloud-api/pdf-edit/logo.png",
            "x": 220,
            "y": 150,
            "width": 159,
            "height": 43,
            "pages": "0"

The PDF Editor Web API cURL sample code is available here.

Let’s see the PDF Editor Web API in action using our cURL sample code.

Add Image Stamp Web API Demo
PDF Editor Web API Demo

PDF Editor Web API JavaScript sample code is available here.

PDF Editor Web API PHP sample code is available here.

PDF Editor Web API Python sample code is available here.

PDF Editor Web API Java sample code is available here.

PDF Editor Web API C# sample code is available here.