API Access

Powerful AI Summarization API

Integrate SMMRY's industry-leading AI summarization technology directly into your applications. Process text, URLs, and documents at scale with our reliable REST API.

99.9%Uptime
50msAvg Response
20+Languages
API Request
POST
/api/process-summarize
Headers:
x-api-key: sk-smmry-abcdxyz

{ "web_url": "..." }
Response200 OK
Summary Generated
Words: 1,247 → 15687% reduction

Built for Developers

Our API is designed with developer experience in mind. Simple to integrate, powerful to scale, and reliable for production use.

RESTful API Design

Clean, intuitive endpoints following REST principles for easy integration.

Lightning Fast

Average response time under 50ms with 99.9% uptime guaranteed.

20+ Languages

Process content in multiple languages with automatic detection.

Enterprise Security

Bank-level encryption with no data retention after processing.

Multiple Input Types

Support for text, URLs, PDFs, and document uploads.

Scalable Architecture

Handle thousands of requests per minute with auto-scaling.

Powerful Capabilities

Our AI-powered summarization engine provides unmatched accuracy and flexibility for all your content processing needs.

  • Process Any Content Type

    From research papers to news articles, our API handles it all.

  • Custom Summary Lengths

    Control output length from brief bullet points to detailed overviews.

  • Real-time Processing

    Get summaries instantly without queuing or delays.

  • Batch Processing

    Submit multiple documents at once for efficient processing.

URL Input
https://example.com/article
Text Input
Summary Output
90% Faster

API Documentation

Everything you need to integrate our summarization API into your applications.

Base URL

https://smmry.com

Authentication

Our API uses API key authentication. Include your API key in the request headers as x-api-key.

curl -H "x-api-key: your-api-key-here" https://smmry.com/api/...

Get your API key: Sign up for an account and visit yourAPI dashboardto generate your API key and purchase credits.

POST/api/process-summarize

Summarize Content

Generate AI-powered summaries from text, URLs, or files. Provide one of: raw_text, web_url, or pdf_b64.

Parameters

x-api-keystringrequired

Your API key (sent as header)

raw_textstringoptional

Raw text to summarize (for text input)

web_urlstringoptional

URL to summarize (for URL input)

pdf_b64stringoptional

Base64 encoded PDF content (for file input)

file_namestringoptional

File name for PDF uploads (optional, e.g., 'document.pdf')

num_of_sentencesnumberoptional

Number of sentences in summary (default: 7)

language_codestringoptional

Language for summarization (default: 'English')

avoid_questionsbooleanoptional

Exclude questions from summary (default: false)

avoid_exclamationsbooleanoptional

Exclude exclamations from summary (default: false)

avoid_quotationsbooleanoptional

Exclude quotations from summary (default: false)

Examples

Request
POST /api/process-summarize
Headers:
x-api-key: your-api-key-here

{
  "raw_text": "Your long text content here...",
  "num_of_sentences": 5,
  "language_code": "English",
  "avoid_questions": true
}
Response
{
  "request_id": 123
}
GET/api/get-summary

Retrieve Summary

Get a previously generated summary by request ID

Parameters

request_idnumberrequired

Request ID from the summarize endpoint

x-api-keystringrequired

Your API key (sent as header)

Examples

Request
GET /api/get-summary?request_id=123
Headers:
x-api-key: your-api-key-here
Response
{
  "summary": "This is the retrieved summary..."
}

📝 Usage Notes

Input Types: Provide exactly one of: raw_text,web_url, orpdf_b64
Asynchronous Processing: The /process-summarize endpoint returns immediately with a request_id. Poll the/get-summary endpoint to retrieve the completed summary.
Languages Supported: English, Spanish, French, German, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Korean, and more.
PDF Files: For PDF summarization, encode your file in base64 and send it via thepdf_b64 parameter.

Error Responses

400Bad Request

Invalid request parameters or missing required fields

401Unauthorized

Invalid or missing API key

429Too Many Requests

Active request in progress. Wait for it to complete or insufficient credits.

500Server Error

Internal server error. Please try again later.

Code Examples

Get started quickly with these code examples in your favorite programming language.

// Step 1: Start summarization
const submitResponse = await fetch('https://smmry.com/api/process-summarize', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your-api-key-here'
  },
  body: JSON.stringify({
    raw_text: 'Your long text content here...',
    num_of_sentences: 5,
    language_code: 'English',
    avoid_questions: true
  })
});

const { request_id } = await submitResponse.json();

// Step 2: Poll for summary (it processes asynchronously)
let summary = null;
while (!summary) {
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2s
  
  const summaryResponse = await fetch(
    `https://smmry.com/api/get-summary?request_id=${request_id}`, {
    headers: {
      'x-api-key': 'your-api-key-here'
    }
  });
  
  const data = await summaryResponse.json();
  if (data.summary) {
    summary = data.summary;
  }
}

console.log('Summary:', summary);
1

Get API Access

Contact our team to get your API credentials and authentication details.

2

Make Your First Call

Use the code examples above to make your first API request and get a summary.

3

Scale Your App

Integrate summarization into your workflow and scale with our robust infrastructure.

SDKs Coming Soon

We're working on official SDKs to make integration even easier.

Node.js SDK
Python SDK
PHP SDK
Ruby SDK

API Pricing

Simple, transparent credit-based pricing. Pay only for what you use.

Pay As You Go

Credit-Based Pricing

1 credit per 750,000 input tokens processed

~$1 USD
per credit (average)
Process text, URLs, and documents
20+ languages supported
99.9% uptime SLA
No monthly subscriptions
Get API Key & Buy Credits

Credits can be purchased in packages with volume discounts from your API dashboard.

• No setup fees• Credits never expire• Volume discounts available• Enterprise support

How are credits calculated?

Each summarization request consumes credits based on the exact number of tokens processed. 750,000 input tokens = 1 credit. You pay only for what you use with precise decimal calculations.

Do credits expire?

No! Your credits never expire. Purchase once and use them at your own pace. Perfect for projects with variable usage patterns.

Can I get volume discounts?

Yes! We offer volume discounts starting from 250+ credits. Larger packages provide better value per credit.

What happens if I run out of credits?

API requests will return an insufficient credits error. Simply purchase more credits from your dashboard to continue.

Frequently Asked Questions

Got questions about our API? Find answers to the most common questions below.

Getting started is easy! First, contact our team to request API access. Once approved, you'll receive your authentication credentials and can start making API calls immediately. We provide comprehensive documentation and code examples to help you integrate quickly.

Still have questions?

Our developer support team is here to help you get the most out of our API. Reach out with any technical questions or integration challenges.