Brave Search

Brave Summarizer Search API

Response Objects

# SummarizerSearchApiResponse

Top level response model for successful Summarizer Search API requests. The response will include the summarized content or answer based on the key. The API can also respond back with an error response based on the incompleted summarization request, invalid subscription keys, and rate limit events. Access to Summarizer requires a subscription to Pro AI plan.

Field	Type	Required	Description
type	"summarizer"	true	The type of summarizer search API result. The value is always `summarizer`.
status	string	true	The current status of summarizer for the given key. The value can be either failed or complete.
title	string	false	The title for the summary.
summary	list [ SummaryMessage ]	false	Details for the summary message.
enrichments	SummaryEnrichments	false	Enrichments that can be added to the summary message.
followups	list [ string ]	false	Followup queries relevant to the current query.
entities_infos	dict [ string, SummaryEntityInfo ]	false	Details on the entities in the summary message.

# SummaryMessage

The summary message.

Field	Type	Required	Description
type	string	true	The type of subset of a summary message. The value can be `token` (a text excerpt from the summary), `enum_item` (a summary entity), `enum_start` (describes the beginning of summary entities, which means the following item(s) in the summary list will be entities), or `enum_end` (the end of summary entities).
data	SummaryEntity \| string	false	The summary entity or the explanation for the type field. For type `enum_start` the value can be `ol` or `ul`, which means an ordered list or an unordered list of entities follows respectively. For type `enum_end` there is no value. For type `token` the value is a text excerpt. For type `enum_item` the value is the SummaryEntity response model.

# TextLocation

Index-based location in a text.

Field	Type	Required	Description
start	int	true	The 0-based index, where the important part of the text starts.
end	int	true	The 0-based index, where the important part of the text ends.

# SummaryEntity

An entity in the summary message.

Field	Type	Required	Description
uuid	string	true	A unique identifier for the entity.
name	string	true	The name of the entity.
url	string	false	The URL where further details on the entity can be found.
text	string	false	A text message describing the entity.
images	list [ SummaryImage ]	false	The image associated with the entity.
highlight	list [ TextLocation ]	false	The location of the entity in the summary message.

# Thumbnail

Aggregated details representing a picture thumbnail.

Field	Type	Required	Description
src	string	true	The served URL of the picture thumbnail.
original	string	false	The original URL of the image.

# ImageProperties

Metadata on an image.

Field	Type	Required	Description
url	string	true	The image URL.

# Image

A model describing an image.

Field	Type	Required	Description
thumbnail	Thumbnail	true	The thumbnail associated with the image.
url	string	false	The URL of the image.
properties	ImageProperties	false	Metadata on the image.

# SummaryImage (Image)

An image associated with the summary.

Field	Type	Required	Description
text	string	false	Text associated with the image.

# SummaryEnrichments

Enrichments associated with the summary message.

Field	Type	Required	Description
raw	string	true	The raw summary message.
images	list [ SummaryImage ]	false	The images associated with the summary.
qa	list [ SummaryAnswer ]	false	The answers in the summary message.
entities	list [ SummaryEntity ]	false	The entities in the summary message.
context	list [ SummaryContext ]	false	References based on which the summary was built.

# SummaryAnswer

The answer if the query is a question.

Field	Type	Required	Description
answer	string	true	The answer text.
score	float	false	A score associated with the answer.
highlight	TextLocation	false	The location of the answer in the summary message.

# MetaUrl

Aggregated information about a URL.

Field	Type	Required	Description
scheme	string	false	The protocol scheme extracted from the URL.
netloc	string	false	The network location part extracted from the URL.
hostname	string	false	The lowercased domain name extracted from the URL.
favicon	string	false	The favicon used for the URL.
path	string	false	The hierarchical path of the URL useful as a display string.

# SummaryContext

A reference for the summary.

Field	Type	Required	Description
title	string	true	The title of the reference.
url	string	true	The URL where the reference can be found.
meta_url	MetaUrl	false	Details on the URL associated with the reference.

# SummaryEntityInfo

Details on the entity in the summary message.

Field	Type	Required	Description
provider	string	false	The name of the provider.
description	string	false	Description of the entity.