{"openapi":"3.1.0","info":{"title":"Sentiment & NLP API","version":"1.0.0","description":"Analyse text in real time: sentiment scoring (positive / negative / neutral with the matched words), automatic language detection across 180+ languages, and a combined analysis endpoint with text statistics. No setup, no model hosting.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nlp-api","description":"oanor gateway"}],"tags":[{"name":"NLP"}],"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/analyze":{"get":{"operationId":"get_v1_analyze","tags":["NLP"],"summary":"Sentiment + language + statistics","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"Text to analyse","schema":{"type":"string"},"example":"Great service. Very happy!"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"Great service. Very happy!","stats":{"char_count":26,"word_count":4,"sentence_count":2,"avg_word_length":5.75},"language":{"language":"deu","reliable":true,"alternatives":[{"score":1,"language":"deu","language_name":"German"},{"score":0.984,"language":"eng","language_name":"English"},{"score":0.962,"language":"nno","language_name":"nno"},{"score":0.933,"language":"nds","language_name":"nds"},{"score":0.872,"language":"dan","language_name":"Danish"}],"language_name":"German"},"sentiment":{"label":"positive","score":6,"comparative":1.5,"token_count":4,"negative_words":[],"positive_words":["happy","great"]}},"meta":{"timestamp":"2026-05-29T23:19:52.172Z","request_id":"af70f7de-f3f9-4c9b-889a-7e3e3b277f33"},"status":"ok","message":"Text analyzed successfully","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/language":{"get":{"operationId":"get_v1_language","tags":["NLP"],"summary":"Language detection","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"Text to detect language of","schema":{"type":"string"},"example":"Das ist ein Test"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"Das ist ein Test","language":"src","reliable":true,"alternatives":[{"score":1,"language":"src","language_name":"src"},{"score":0.99,"language":"deu","language_name":"German"},{"score":0.846,"language":"est","language_name":"Estonian"},{"score":0.791,"language":"glg","language_name":"Galician"},{"score":0.715,"language":"fin","language_name":"Finnish"}],"language_name":"src"},"meta":{"timestamp":"2026-05-29T23:19:52.243Z","request_id":"ce1474a6-57fc-49c4-bc35-b4cfdffee7f5"},"status":"ok","message":"Language detected successfully","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/sentiment":{"get":{"operationId":"get_v1_sentiment","tags":["NLP"],"summary":"Sentiment analysis","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"Text to analyse","schema":{"type":"string"},"example":"I love this product"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"I love this product","label":"positive","score":3,"comparative":0.75,"token_count":4,"negative_words":[],"positive_words":["love"]},"meta":{"timestamp":"2026-05-29T23:19:52.292Z","request_id":"9d8d5e68-654e-4ff8-9bf8-7f5e4b803cae"},"status":"ok","message":"Sentiment analyzed successfully","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":5000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1400,"monthly_call_quota":120000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4200,"monthly_call_quota":600000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":11900,"monthly_call_quota":2500000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nlp-api"}