Text Analytics | Sarvam API Docs

1 curl -X POST https://api.sarvam.ai/text-analytics \ 2 -H "api-subscription-key: <apiSubscriptionKey>" \ 3 -H "Content-Type: application/x-www-form-urlencoded" \ 4 --data-urlencode text="Climate change is a critical global challenge that demands immediate attention. Rising temperatures, extreme weather events, and sea level rise are just a few of the consequences we're already experiencing. Scientists emphasize the urgency of limiting global warming to 1.5°C above pre-industrial levels to avoid the most severe consequences. This requires significant reductions in greenhouse gas emissions across all sectors of society." \ 5 -d questions=questions

1 { 2 "request_id": "request_id", 3 "answers": [ 4 { 5 "id": "q001", 6 "question": "What is the main topic of this text?", 7 "reasoning": "The text consistently discusses the global issue of climate change, its causes, effects, and the urgency of addressing it.", 8 "response": "Climate change", 9 "utterance": "Climate change is a critical global challenge that demands immediate attention." 10 }, 11 { 12 "id": "q002", 13 "question": "What is the recommended temperature increase limit?", 14 "reasoning": "The text explicitly states the recommended limit for global warming to avoid severe consequences.", 15 "response": "1.5°C", 16 "utterance": "Scientists emphasize the urgency of limiting global warming to 1.5°C above pre-industrial levels to avoid the most severe consequences." 17 }, 18 { 19 "id": "q003", 20 "question": "Does the text mention sea level rise as a consequence of climate change?", 21 "reasoning": "The text explicitly lists sea level rise as one of the consequences of climate change.", 22 "response": "true", 23 "utterance": "Rising temperatures, extreme weather events, and sea level rise are just a few of the consequences we're already experiencing." 24 } 25 ] 26 }

This endpoint performs comprehensive text analysis on provided content and answers specific questions about the text. Each response is supported by reasoning and the exact phrase extracted from the content.

Headers

api-subscription-keystringRequired

Request

This endpoint expects an object.

textstringRequired

The text content to be analyzed. This should be a non-empty string containing the full text for analysis.

questionsstringRequired

List of questions to be answered based on the call content. Each question should be a valid JSON object with the following structure: {id: string, text: string, description: string (optional), type: string, properties: object}.The type field must be one of: boolean, enum, short answer, long answer, or number. For enum type questions, include an ‘options’ list in the properties.

Response

Successful Response

request_idstringOptional

answerslist of objectsOptional

List of answers derived from the text analysis. Each answer corresponds to a question from the original request. This field will be null if no valid answers could be generated.

Headers

Request

Response

Errors