{"openapi":"3.1.0","info":{"title":"Summarize API","version":"1.0.0","description":"Summarize text and pull out its keywords — no AI key, no external model. The summarize endpoint is extractive: it scores every sentence by word frequency and position and returns the most representative ones (ask for a fixed number of sentences or a fraction of the original), keeping the author's exact wording and order. The keywords endpoint ranks the most salient terms with their counts and a relative score, filtering out stopwords. Because it is deterministic and runs locally, the same text always gives the same result, instantly and privately. Perfect for article previews and TL;DRs, search snippets, tagging and content triage, and feeding shorter context to downstream tools. Pure local computation — no third-party service; send long text via POST. Live, nothing stored. 3 endpoints. Distinct from sentiment/NLP analysis, stopword lists and Unicode text segmentation.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/summarize-api","description":"oanor gateway"}],"tags":[{"name":"Summarize"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/keywords":{"get":{"operationId":"get_v1_keywords","tags":["Summarize"],"summary":"Extract keywords","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"Text to analyse","schema":{"type":"string"},"example":"Artificial intelligence is transforming industries worldwide. Machine learning models can now translate languages, recognize images and generate text. These AI systems learn from vast amounts of data. Companies invest heavily in artificial intelligence research. The future of AI promises even greater automation across the economy."},{"name":"limit","in":"query","required":false,"description":"How many (default 10)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"keywords":[{"word":"ai","count":2,"score":1},{"word":"artificial","count":2,"score":1},{"word":"intelligence","count":2,"score":1},{"word":"amounts","count":1,"score":0.5},{"word":"automation","count":1,"score":0.5}]},"meta":{"timestamp":"2026-06-03T01:09:50.253Z","request_id":"ac3ac912-7f5d-4081-90b7-dbb952738572"},"status":"ok","message":"Extract keywords","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/summarize":{"get":{"operationId":"get_v1_summarize","tags":["Summarize"],"summary":"Summarize text","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"Text to summarize","schema":{"type":"string"},"example":"Artificial intelligence is transforming industries worldwide. Machine learning models can now translate languages, recognize images and generate text. These AI systems learn from vast amounts of data. Companies invest heavily in artificial intelligence research. The future of AI promises even greater automation across the economy."},{"name":"sentences","in":"query","required":false,"description":"How many sentences (default 3)","schema":{"type":"string"},"example":"2"},{"name":"ratio","in":"query","required":false,"description":"Or a fraction 0-1","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"summary":"Artificial intelligence is transforming industries worldwide. Companies invest heavily in artificial intelligence research.","sentences":["Artificial intelligence is transforming industries worldwide.","Companies invest heavily in artificial intelligence research."],"summary_sentence_count":2,"original_sentence_count":5},"meta":{"timestamp":"2026-06-03T01:09:50.349Z","request_id":"5d73812f-7d7c-4dd8-82e7-8fced3459d84"},"status":"ok","message":"Summarize text","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Summarize API","notes":"Extractive (it selects existing sentences, never rewrites). Stopword filtering is tuned for English. Send long text via POST. Nothing is stored.","version":"v1","endpoints":[{"path":"/v1/summarize","params":{"text":"the text (required)","ratio":"or a fraction 0-1","sentences":"how many (default 3)"},"returns":"summary + the chosen sentences"},{"path":"/v1/keywords","params":{"text":"the text (required)","limit":"how many (default 10)"},"returns":"ranked keywords with counts and scores"},{"path":"/v1/meta","params":[],"returns":"this document"}],"description":"Extractive text summarization and keyword extraction. Picks the most representative sentences (by word-frequency and position) and ranks the most salient keywords. Deterministic, pure local, no key."},"meta":{"timestamp":"2026-06-03T01:09:50.447Z","request_id":"bda873a3-6297-4e06-899d-d62479376136"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":780,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":120,"monthly_call_quota":6300,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1920,"monthly_call_quota":126000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5520,"monthly_call_quota":650000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/summarize-api"}