---
title: Pdf Parser
slug: connectors/pdf-parser
docTags: 
createdAt: 2026-06-09T16:29:42.288Z
---

## PDF Utilities

PDF Parser enables automated extraction and security analysis of PDF documents to identify content and potential threats.

PDF Parser enables automated extraction and analysis of PDF files, allowing security teams to detect threats such as embedded scripts or malicious actions within documents. This connector provides capabilities to parse text content, decrypt password-protected PDFs, and identify suspicious elements, all without manual intervention. By integrating PDF Parser with Swimlane Turbine, users can seamlessly incorporate PDF analysis into their security workflows, accelerating threat detection and response. This empowers organizations to efficiently process and investigate PDF-based threats as part of their broader security automation strategy.

## Capabilities

The PDF Utilities connector has the following capabilities

- Analyze a PDF for strings using PDFiD
- Parse a PDF to extract text

# Actions

## Analyze PDF

Extract and analyze content from a PDF attachment to identify potential threats, such as embedded JavaScript or actions triggered upon opening.

### Endpoint

- **Method:** `GET`

### Input

| **Argument Name**         | **Type** | **Required** | **Description**           |
| ------------------------- | -------- | ------------ | ------------------------- |
| `eval`                    | string   | Optional     | Python to eval            |
| `attachments`             | array    | Required     | File to be uploaded       |
| `attachments.file`        | string   | Optional     | Parameter for Analyze PDF |
| `attachments.file_name`   | string   | Optional     | Name of the resource      |
| `attachments.description` | string   | Optional     | Parameter for Analyze PDF |

### Input Example

`{"eval":"string","attachments":[{"file":"string","file_name":"Example Name","description":"string"}]}`

### Output

| **Parameter** | **Type** | **Description** |
| ------------- | -------- | --------------- |
| `output`      | string   | PDF Information |

### Output Example

`{"output":"string"}`

## Parse PDF

Extract text content from a provided PDF file attachment for further analysis or processing.

### Input

| **Argument Name**         | **Type** | **Required** | **Description**                                                                                                                              |
| ------------------------- | -------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `attachments`             | array    | Required     | File to be uploaded                                                                                                                          |
| `attachments.file`        | string   | Optional     | Parameter for Parse PDF                                                                                                                      |
| `attachments.file_name`   | string   | Optional     | Name of the resource                                                                                                                         |
| `attachments.description` | string   | Optional     | Parameter for Parse PDF                                                                                                                      |
| `format_output`           | boolean  | Optional     | If False, the entire PDF data will be returned as plain text. If True, the pdf data will be formatted to the extent possible (not perfect!). |
| `password`                | string   | Optional     | Password to decrypt the PDF file.                                                                                                            |

### Input Example

`{"attachments":[{"file":"string","file_name":"Example Name","description":"string"}],"format_output":true,"password":"string"}`

### Output

| **Parameter**                        | **Type** | **Description**  |
| ------------------------------------ | -------- | ---------------- |
| `pdf_formatted_content`              | array    | Response content |
| `pdf_formatted_content.page_number`  | number   | Response content |
| `pdf_formatted_content.page_content` | string   | Response content |
| `pdf_text_content`                   | string   | Response content |

### Output Example

`{"pdf_formatted_content":[{"page_number":1,"page_content":"some content"}]}`

# Response Headers

| **Header**   | **Description**                                       | **Example**                   |
| ------------ | ----------------------------------------------------- | ----------------------------- |
| Content-Type | The media type of the resource                        | application/json              |
| Date         | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |