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.
x-api-key: sk-smmry-abcdxyz
{ "web_url": "..." }
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.
API Documentation
Everything you need to integrate our summarization API into your applications.
Base URL
https://smmry.comAuthentication
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.
/api/process-summarizeSummarize Content
Generate AI-powered summaries from text, URLs, or files. Provide one of: raw_text, web_url, or pdf_b64.
Parameters
x-api-keystringrequiredYour API key (sent as header)
raw_textstringoptionalRaw text to summarize (for text input)
web_urlstringoptionalURL to summarize (for URL input)
pdf_b64stringoptionalBase64 encoded PDF content (for file input)
file_namestringoptionalFile name for PDF uploads (optional, e.g., 'document.pdf')
num_of_sentencesnumberoptionalNumber of sentences in summary (default: 7)
language_codestringoptionalLanguage for summarization (default: 'English')
avoid_questionsbooleanoptionalExclude questions from summary (default: false)
avoid_exclamationsbooleanoptionalExclude exclamations from summary (default: false)
avoid_quotationsbooleanoptionalExclude 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
}/api/get-summaryRetrieve Summary
Get a previously generated summary by request ID
Parameters
request_idnumberrequiredRequest ID from the summarize endpoint
x-api-keystringrequiredYour 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
raw_text,web_url, orpdf_b64/process-summarize endpoint returns immediately with a request_id. Poll the/get-summary endpoint to retrieve the completed summary.pdf_b64 parameter.Error Responses
Invalid request parameters or missing required fields
Invalid or missing API key
Active request in progress. Wait for it to complete or insufficient credits.
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);Get API Access
Contact our team to get your API credentials and authentication details.
Make Your First Call
Use the code examples above to make your first API request and get a summary.
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.
API Pricing
Simple, transparent credit-based pricing. Pay only for what you use.
Credit-Based Pricing
1 credit per 750,000 input tokens processed
Credits can be purchased in packages with volume discounts from your API dashboard.
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.