Skip to main content
Renamed.to logorenamed.to

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
View on GitHubREST API docs

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/sdk
View docs

Python

Works with Python 3.8+ and async/await.

pip install renamed
View docs

Go

Idiomatic Go with context support.

go get github.com/renamed-to/renamed-sdk/sdks/go
View docs

Ruby

Ruby 2.7+ with Rails integration.

gem install renamed
View docs

PHP

PHP 8.0+ with PSR-18 HTTP client.

composer require renamed/sdk
View docs

C# / .NET

.NET 6+ with async/await patterns.

dotnet add package Renamed.Sdk
View docs

Rust

Async Rust with tokio runtime.

cargo add renamed
View docs

Java

Java 11+ with CompletableFuture.

to.renamed:renamed-sdk:0.1.0
View docs

Swift

Swift Package Manager for iOS and server-side Swift.

.package(url: "https://github.com/renamed-to/renamed-sdk", from: "0.1.0")
View docs

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

Renamer API →REST API for PDF renaming.PDF Split API →REST API for document splitting.API Documentation →Complete API reference and guides.API Tokens →Generate and manage API keys.