​
Getting Started

Learn how to quickly integrate with our API endpoints for document extraction and processing.

Prerequisites:

  • You’ll need an API key and an active subscription tier to get started. Contact our support team if you haven’t received these yet.
  • Check out our pricing page for subscription options

​
Choose Your Integration Path

/convert Endpoint

Direct file upload for quick processing of files up to 6MB

/extract Endpoint

Process documents via URL for larger files and advanced chunking options

​
Quick Implementation

​
Using the Convert Endpoint

Upload File

Send your PDF directly to the endpoint:

curl --location 'https://api.runpulse.com/convert' \
  --header 'Content-Type: application/pdf' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data-binary '@/path/to/your/file.pdf'

Retrieve Results

You’ll receive a JSON response with presigned URL and S3 object URL:

{
  "presigned_url": "https://bucket-name.s3.amazonaws.com/path/to/file.pdf?[signed-parameters]",
  "s3_object_url": "https://bucket-name.s3.amazonaws.com/path/to/file.pdf",
  "statusCode": 200
}

​
Using the Extract Endpoint

Prepare Your Request

Include your API key in the headers and specify the file URL:

curl --location 'https://api.runpulse.com/extract' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data-raw '{
    "file-url": "YOUR_FILE_URL",
    "chunking": "semantic,recursive",
    "return_table": true,
    "schema": {}
  }'

Examples of chunking combinations:

  • chunking=semantic,recursive
  • chunking=page,header
  • chunking=semantic,recursive,page,header
  • chunking=semantic

Process Response

You’ll receive a JSON response containing:

  • Markdown content
  • Processed chunks
  • Plan information
  • Schema-based extracted data

​
Available Chunking Options

Semantic

Splits content based on meaning and context

Recursive

Iteratively breaks down content into smaller segments

Page

Divides content by individual pages

Header

Splits content based on document headers

​
Response Format

​
Next Steps

API Reference

Explore detailed API specifications and examples

Security Best Practices

Learn about securing your API integration

Need help? Email us at founders@trypulse.ai.

API OverviewSecurity Overview