SDK or REST API?
Use the SDK when
- You are building in one of the supported languages
- You want authentication, JSON parsing, and pagination handled automatically
- Your use case is reading content — pages, collections, blog posts, feeds
Use the REST API directly when
- Your language does not have an official SDK
- You need to create, update, or delete content via the Write API
- You need the Image Transformation API or Webhooks API
- You need fine-grained control over HTTP behavior, caching headers, or CDN interaction
- You are minimizing dependencies (serverless functions, edge workers, embedded environments)
Need a full app? See Starter Projects.