← Back to all apps

Overview

Tools Available2
DeveloperTonita, Inc.
CategoryShopping

Apparel and accessories search

Available Tools

Tonita provides 2 tools that can be used to interact with its services.

Tonita Get Listing Details

tonita-get-listing-details
Full Description

Get the details for one or more listings.

Given a list of listing IDs, this tool returns the full details for each listing, including title, description, price, brand, images, and other metadata.

Use this tool when you need to retrieve detailed information about specific products that have already been shown to the user, for example:

  • When the user asks for more information about specific products
  • When you need to understand the details of products before searching for similar items
  • When the user wants to compare specific products

Parameters

Required
listing_idsarray

A list of listing IDs to retrieve details for. Each listing ID is a unique identifier for a product in the Tonita catalog.

Tonita Search

tonita-search
Full Description

Search Tonita to find products that match the user's intent.

The query parameter is the main search query used for ranking results. The additional_queries parameter can include variations of the query to improve retrieval coverage.

NOTE: The search engine does NOT have much "world knowledge". That means queries should not contain any pop-culture references, trendy terms, or other cultural references.

NOTE: Queries must NOT contain any references to other listings. For example, if the user has expressed they want items similar to previously-shown listings X, Y and Z, do not include "similar to X, Y and Z" in the queries. Instead, first gather the product details of X, Y and Z, and then use those details to construct the queries.

NOTE: This function is meant to search for one specific type of item. For example, do not use a single search call to search for shirts and pants and shoes. Instead, make three separate calls to this function.

NOTE: It is OK if not every detail is provided. For example, if the user does not have a brand/domain preference, set the corresponding parameter to null.

Parameters

Required
gender

The target gender for the product.

product_typestring

The type of product to search for (e.g., 'dress', 'jacket', 'sneakers').

querystring

The main search query describing what the user is looking for. This will be used for ranking results.

Optional
additional_queriesarray

Additional query variations to improve retrieval coverage. These are different phrasings of the same intent.

Default: null
exclude_brandsarray

Brands to exclude from the search results. Set to null if no brands to exclude.

Default: null
exclude_domainsarray

Domains/retailers to exclude from the search results. Set to null if no domains to exclude.

Default: null
include_brandsarray

Brands to include in the search results. Set to null if no brand preference.

Default: null
include_domainsarray

Domains/retailers to include in the search results. Set to null if no domain preference.

Default: null