Web Search API, REST: ImageSearch.SearchByImage

Field

Description

site

string

Restricts the search to the specific website.

folderId

string

ID of the folder.

url

string

Required field. The image url to use for the search.

Includes only one of the fields url, data, id.

data

string (bytes)

Required field. The image data to use for the search.

Includes only one of the fields url, data, id.

id

string

Required field. CBIR ID of the image to use for the search.

Includes only one of the fields url, data, id.

page

string (int64)

The number of a requested page with search results.

familyMode

enum (FamilyMode)

Rule for filtering search results and determines whether any documents should be excluded.

• FAMILY_MODE_UNSPECIFIED
• FAMILY_MODE_NONE: Filtering is disabled. Search results include any documents regardless of their contents.
• FAMILY_MODE_MODERATE: Moderate filter (default value). Documents of the Adult category are excluded from search results
  unless a query is explicitly made for searching resources of this category.
• FAMILY_MODE_STRICT: Regardless of a search query, documents of the Adult category
  and those with profanity are excluded from search results.

Field

Description

images[]

ImageInfo

The images found.

page

string (int64)

The number of the page with search results.

maxPage

string (int64)

id

string

CBIR ID of the image used for the search.

Field

Description

url

string

Image URL.

format

enum (ImageFormat)

Image format.

• IMAGE_FORMAT_UNSPECIFIED
• IMAGE_FORMAT_JPEG: JPG format.
• IMAGE_FORMAT_GIF: GIF format.
• IMAGE_FORMAT_PNG: PNG format.

width

string (int64)

Image width.

height

string (int64)

Image height.

passage

string

Text passage.

host

string

Document host.

pageTitle

string

Document title.

pageUrl

string

Document URL.