API Reference

Authorization: Bearer YOUR_API_KEY

# Install: curl is available on all platforms

curl -X POST https://summarizeapi.com/api/summarize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Your text here..."}'

{
  "success": true,
  "summary": "A concise summary of your text.",
  "keywords": null,
  "original_length": 1234,
  "summary_length": 287,
  "processing_time": 3.14,
  "requests_remaining": 98
}

{
  "text": "Artificial intelligence is transforming industries...",
  "length": "medium",
  "style": "professional",
  "format": "paragraph",
  "outputLang": "en",
  "includeKeywords": true
}

{
  "success": true,
  "summary": "Generated summary text.",
  "keywords": "AI, machine learning, automation, data, neural networks",
  "original_length": 1842,
  "summary_length": 312,
  "processing_time": 2.85,
  "requests_remaining": 4997
}

const streamSummary = async (text, onChunk, onDone) => {
  const res = await fetch('https://summarizeapi.com/api/summarize?stream=1', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ text })
  });

  const reader = res.body.getReader();
  const decoder = new TextDecoder();

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    const lines = decoder.decode(value).split('\n');
    for (const line of lines) {
      if (!line.startsWith('data: ')) continue;
      const event = JSON.parse(line.slice(6));
      if (event.type === 'summary') onChunk(event.content);
      if (event.type === 'done')    onDone(event.summary);
    }
  }
};

// Usage
streamSummary(
  'Your text here...',
  chunk => process.stdout.write(chunk),
  full  => console.log('\n\nDone. Full summary:', full)
);

{
  "error": "Invalid API key"
}

curl -X POST https://summarizeapi.com/api/summarize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Artificial intelligence is reshaping modern industries. From predictive analytics in finance to computer vision in healthcare, AI applications are becoming integral to business strategy. Natural language processing enables machines to understand and generate human text, while reinforcement learning allows systems to optimize complex decisions through trial and error.",
    "length": "short",
    "style": "professional",
    "format": "paragraph",
    "outputLang": "en",
    "includeKeywords": true
  }'

curl -X POST "https://summarizeapi.com/api/summarize?stream=1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --no-buffer \
  -d '{"text": "Your long text here..."}'

# Output (streamed):
# data: {"type":"summary","content":"AI is"}
# data: {"type":"summary","content":" transform"}
# ...
# data: {"type":"done","summary":"Full summary text."}
# data: [DONE]

class SummarizeAPI {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseURL = 'https://summarizeapi.com/api';
  }

  async summarize(text, options = {}) {
    const res = await fetch(`${this.baseURL}/summarize`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ text, ...options })
    });

    if (!res.ok) {
      const err = await res.json();
      throw new Error(err.error);
    }
    return res.json();
  }
}

// Usage
const client = new SummarizeAPI('YOUR_API_KEY');

const result = await client.summarize(
  'Your long text here...',
  { length: 'medium', style: 'professional', includeKeywords: true }
);

console.log('Summary:', result.summary);
console.log('Keywords:', result.keywords);
console.log('Compression:', Math.round((1 - result.summary_length / result.original_length) * 100) + '%');

import requests

class SummarizeAPI:
    BASE_URL = "https://summarizeapi.com/api"

    def __init__(self, api_key: str):
        self.session = requests.Session()
        self.session.headers.update({"Authorization": f"Bearer {api_key}"})

    def summarize(self, text: str, **kwargs) -> dict:
        response = self.session.post(
            f"{self.BASE_URL}/summarize",
            json={"text": text, **kwargs}
        )
        response.raise_for_status()
        return response.json()


# Usage
client = SummarizeAPI("YOUR_API_KEY")

result = client.summarize(
    text="Artificial intelligence is reshaping industries...",
    length="medium",
    style="academic",
    output_lang="en",
    include_keywords=True
)

print(f"Summary: {result['summary']}")
print(f"Keywords: {result['keywords']}")
print(f"Reduced by {100 - round(result['summary_length'] / result['original_length'] * 100)}%")

<?php

class SummarizeAPI {
    private string $apiKey;
    private string $baseUrl = 'https://summarizeapi.com/api';

    public function __construct(string $apiKey) {
        $this->apiKey = $apiKey;
    }

    public function summarize(string $text, array $options = []): array {
        $payload = json_encode(array_merge(['text' => $text], $options));
        $ch = curl_init($this->baseUrl . '/summarize');
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => $payload,
            CURLOPT_HTTPHEADER     => [
                'Authorization: Bearer ' . $this->apiKey,
                'Content-Type: application/json'
            ],
            CURLOPT_TIMEOUT        => 60
        ]);
        $body     = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($httpCode !== 200) {
            $err = json_decode($body, true);
            throw new \RuntimeException($err['error'] ?? 'API error');
        }
        return json_decode($body, true);
    }
}

// Usage
$client = new SummarizeAPI('YOUR_API_KEY');

$result = $client->summarize(
    text: 'Artificial intelligence is reshaping industries...',
    options: ['length' => 'medium', 'includeKeywords' => true]
);

echo $result['summary'] . PHP_EOL;
echo $result['keywords'] . PHP_EOL;