Developer Integration

Official SDKs

Official SDKs to rename PDFs, split them into documents, and extract data with a few lines of code.

  • Install for TypeScript, Python, Go, Java, C#, Ruby, Rust, Swift, and PHP
  • Use the same method names across SDKs: rename, pdfSplit, extract
  • MIT-licensed, open source SDKs maintained by the renamed.to team

All SDKs include

  • File renaming with AI
  • PDF splitting with boundary detection
  • Structured data extraction
  • Auto-retry and error handling

Choose your language

Click on a language to see installation instructions and code examples.

Quickstart examples

All SDKs follow the same patterns. Here are examples in popular languages.

TypeScript
TypeScript
import { RenamedClient } from '@renamed/sdk'const client = new RenamedClient({  apiKey: process.env.RENAMED_API_KEY,})const result = await client.rename(pdfBuffer)console.log(result.suggestedFilename)
Python
Python
from renamed import RenamedClientclient = RenamedClient(api_key=os.environ["RENAMED_API_KEY"])result = client.rename(pdf_bytes)print(result.suggested_filename)
Go
Go
client := renamed.NewClient(os.Getenv("RENAMED_API_KEY"))result, _ := client.Rename(ctx, pdfBytes)fmt.Println(result.SuggestedFilename)

Examples simplified; see per-language pages for full details.

SDK vs REST API

Choose the right approach for your integration needs.

Use SDKs when you want

  • Idiomatic language APIs with type safety
  • Built-in retries and error handling
  • Faster time-to-first-success
  • Easier maintenance with versioned packages

Use REST when you need

  • A language without an official SDK
  • Ultra-minimal dependencies
  • Custom retry or caching logic
  • Direct HTTP control for edge cases
View REST API docs

Full SDK documentation on GitHub

Browse per-language READMEs in the renamed-sdk repository for comprehensive docs, advanced examples, and contribution guidelines.

Browse on GitHub

Frequently asked questions

Which SDK should I use?
Choose the SDK for your primary programming language. All SDKs provide the same functionality and follow similar API patterns.
Are the SDKs open source?
Yes, all SDKs are MIT licensed and available on GitHub. Contributions are welcome.
Can I use the REST API directly instead?
Yes, all our APIs are available via REST with Bearer token authentication. The SDKs are convenience wrappers around the REST API.
What methods do the SDKs provide?
All SDKs provide the same core methods: rename() for AI-powered file renaming, pdfSplit() for splitting multi-page PDFs, extract() for structured data extraction, getUser() for account info, and downloadFile() for downloading processed files.

Related resources