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.
TypeScript / Node.js
Full TypeScript support with type definitions included.
npm install @renamed/sdkPython
Works with Python 3.8+ and async/await.
pip install renamedGo
Idiomatic Go with context support.
go get github.com/renamed-to/renamed-sdk/sdks/goRuby
Ruby 2.7+ with Rails integration.
gem install renamedPHP
PHP 8.0+ with PSR-18 HTTP client.
composer require renamed/sdkC# / .NET
.NET 6+ with async/await patterns.
dotnet add package Renamed.SdkRust
Async Rust with tokio runtime.
cargo add renamedJava
Java 11+ with CompletableFuture.
to.renamed:renamed-sdk:0.1.0Swift
Swift Package Manager for iOS and server-side Swift.
.package(url: "https://github.com/renamed-to/renamed-sdk", from: "0.1.0")Quickstart examples
All SDKs follow the same patterns. Here are examples in popular languages.
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)from renamed import RenamedClientclient = RenamedClient(api_key=os.environ["RENAMED_API_KEY"])result = client.rename(pdf_bytes)print(result.suggested_filename)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
Full SDK documentation on GitHub
Browse per-language READMEs in the renamed-sdk repository for comprehensive docs, advanced examples, and contribution guidelines.
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.