POST
/
v1
/
ai
/
summary
import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({ apiKey: "your-api-key" });

const response = await jigsaw.summary({
  "text": "The Leaning Tower of Pisa, or simply, the Tower of Pisa, is the campanile, or freestanding bell tower, of Pisa Cathedral. It is situated behind the Cathedral and is the third-oldest structure in the city's Cathedral Square, after the Cathedral and the Baptistry. The tower's tilt began during construction in the 12th century, caused by an inadequate foundation on ground too soft on one side to properly support the structure's weight. The tilt increased in the decades before the structure was completed in the 14th century. It gradually increased until the structure was stabilized by efforts in the late 20th and early 21st centuries. The height of the tower is 55.86 metres (183.27 feet) from the ground on the low side and 56.67 metres (185.93 feet) on the high side. The width of the walls at the base is 2.44 m (8 ft 0.06 in). Its weight is estimated at 14,500 tonnes. The tower has 296 or 294 steps; the seventh floor has two fewer steps on the north-facing staircase.",
  "type": "points",
  "max_points": 3
})

{
  "success": true,
  "summary": [
        "The Leaning Tower of Pisa is the freestanding bell tower of Pisa Cathedral, located behind the Cathedral in Cathedral Square.",
        "The tower's tilt started in the 12th century due to a weak foundation on soft ground, increasing until stabilization efforts in the late 20th and early 21st centuries.",
        "The tower is approximately 55.86-56.67 meters tall, weighs an estimated 14,500 tonnes, and has either 296 or 294 steps."
  ],
  "_usage": {
        "input_tokens": 256,
        "output_tokens": 112,
        "inference_time_tokens": 1711,
        "total_tokens": 2079
  }
}

​
Request Parameters

​
Body

​
text
string
The text content to summarize. Maximum 300,000 characters. Not required if url or file_store_key is specified.
​
url
string
URL of a PDF document to summarize. Not required if text or file_store_key is provided.
​
file_store_key
string
The key of a stored PDF document to summarize from Jigsawstack File Storage. Not required if text or url is provided.
​
type
string
default:"text"
The format of the summary: - text: Returns a continuous paragraph summary - points: Returns bullet points as an array of strings
​
max_points
number
default:"2"
The maximum number of bullet points to generate when type is set to points. Maximum value is 100.
​
max_characters
number
The maximum number of characters in the generated summary.
​
x-api-key
string
required
Your JigsawStack API key

​
Response Structure

The response structure varies based on the type parameter:

​
When type is “text” (default)

​
summary
string
The generated summary as a continuous paragraph.

​
When type is “points”

​
summary
string[]
An array of strings, where each string represents a bullet point in the summary.
import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({ apiKey: "your-api-key" });

const response = await jigsaw.summary({
  "text": "The Leaning Tower of Pisa, or simply, the Tower of Pisa, is the campanile, or freestanding bell tower, of Pisa Cathedral. It is situated behind the Cathedral and is the third-oldest structure in the city's Cathedral Square, after the Cathedral and the Baptistry. The tower's tilt began during construction in the 12th century, caused by an inadequate foundation on ground too soft on one side to properly support the structure's weight. The tilt increased in the decades before the structure was completed in the 14th century. It gradually increased until the structure was stabilized by efforts in the late 20th and early 21st centuries. The height of the tower is 55.86 metres (183.27 feet) from the ground on the low side and 56.67 metres (185.93 feet) on the high side. The width of the walls at the base is 2.44 m (8 ft 0.06 in). Its weight is estimated at 14,500 tonnes. The tower has 296 or 294 steps; the seventh floor has two fewer steps on the north-facing staircase.",
  "type": "points",
  "max_points": 3
})

{
  "success": true,
  "summary": [
        "The Leaning Tower of Pisa is the freestanding bell tower of Pisa Cathedral, located behind the Cathedral in Cathedral Square.",
        "The tower's tilt started in the 12th century due to a weak foundation on soft ground, increasing until stabilization efforts in the late 20th and early 21st centuries.",
        "The tower is approximately 55.86-56.67 meters tall, weighs an estimated 14,500 tonnes, and has either 296 or 294 steps."
  ],
  "_usage": {
        "input_tokens": 256,
        "output_tokens": 112,
        "inference_time_tokens": 1711,
        "total_tokens": 2079
  }
}