API Reference

Our API offers two powerful ways to integrate blog content into your application. The Raw API returns raw, structured JSON, ideal for developers who want full control over UI, routing, and custom rendering logic. The Rendered API returns fully rendered HTML built with your DropInBlog layout perfect for quickly embedding SEO ready blog pages with minimal frontend work.

Rendered OutputRaw Data
What you getFully built, production-ready HTMLStructured JSON content
Frontend workNone requiredBuild templates or components
Setup speedFastFlexible, but requires more work
UpdatesAutomatic updates and improvementsManual updates and improvements
Best forLow-maintenance blogs with minimal setupCustom designs and full control

Authentication

Our API supports OAuth 2 integration, providing a secure and standardized method for authenticating and authorizing users. There are two types of API keys...

  • Private: Private keys are designed for creating and updating posts, and can not be used to display a blog on your website. Employing them on your frontend poses a security risk.
  • Public: Public keys are used to render your blog on your website.

You can manage your OAuth tokens in your DropInBlog account.

Rate Limits

The default rate limit is 60 requests per minute. Exceeding the rate limit will result in a HTTP 429 error requesting you slow down the rate you are making requests at.

Every request has two rate limit related response headers.

Response HeaderDescription
x-ratelimit-limitContains the current overall rate limit per minute
x-ratelimit-remainingContains the number of available requests remaining in the current minute