Composio search

Learn how to use Composio search with Composio

Overview

SLUG: COMPOSIO_SEARCH

Description

Composio Search provides comprehensive web search across travel (flights, hotels, events), e-commerce (Amazon, Walmart, shopping), financial markets, news, academic research, images, and location services.

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Composio search toolkit’s playground](https://app.composio.dev/app/Composio search)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["COMPOSIO_SEARCH"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Amazon Product Search

Description

Search amazon for products across different country marketplaces. this tool searches amazon's product catalog with support for multiple international amazon domains/marketplaces. each domain serves a different country with local pricing, currency, shipping options, and product availability. perfect for product research, international price comparison, and finding products available in specific countries. returns product details, pricing in local currency, ratings, reviews, and seller information. examples: query="gaming laptop" + amazon domain="amazon.com" for us marketplace query="coffee maker" + amazon domain="amazon.de" for german marketplace query="iphone 15" + amazon domain="amazon.co.uk" for uk marketplace with gbp pricing

Action Parameters

amazon_domain
string
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Exa Answer

Description

Get answers with citations using the exa api. deprecated: use composio search web instead.

Action Parameters

content
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Flight Search

Description

Search for flights with comprehensive pricing, schedule, and airline information. this tool finds available flights between cities/airports with detailed pricing, multiple airlines, departure/arrival times, flight duration, and booking options. supports round-trip and one-way searches, multiple passenger types (adults, children, infants), different travel classes, and international pricing in various currencies. perfect for travel planning, price comparison, and finding the best flight options. examples: departure id="jfk" + arrival id="lax" + outbound date="2025-12-25" + return date="2025-12-30" departure id="lga" + arrival id="lhr" + outbound date="2025-06-01" + adults=2 departure id="lax" + arrival id="nrt" + outbound date="2025-03-15" + travel class=3 + currency="usd"

Action Parameters

adults
integerDefaults to 1
arrival_id
stringRequired
children
integer
currency
string
departure_id
stringRequired
gl
string
hl
string
infants
integer
outbound_date
stringRequired
return_date
string
travel_class
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Hotel Search

Description

Search for hotels and vacation rentals with comprehensive filtering and pricing. this tool finds available accommodations with detailed information including pricing, ratings, amenities, photos, and booking options. supports price range filtering, star rating selection, sorting by various criteria (price, rating, distance), free cancellation options, and vacation rental inclusion. perfect for travel planning, accommodation comparison, and finding the best lodging options for any destination. examples: q="new york" + check in date="2025-06-01" + check out date="2025-06-05" + adults=2 q="paris" + check in date="2025-03-15" + check out date="2025-03-18" + min price=100 + max price=300 q="tokyo" + check in date="2025-12-20" + check out date="2025-12-25" + hotel class="4,5" + sort by=13

Action Parameters

adults
integerDefaults to 2
check_in_date
stringRequired
check_out_date
stringRequired
children
integer
currency
string
free_cancellation
boolean
gl
string
hl
string
hotel_class
string
max_price
integer
min_price
integer
q
stringRequired
sort_by
string
vacation_rentals
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: TripAdvisor Travel Search

Description

Search tripadvisor for travel recommendations and itinerary planning. this tool searches tripadvisor's comprehensive travel database for attractions, restaurants, hotels, tours, and activities. perfect for creating travel itineraries, finding top-rated experiences, discovering local recommendations, and planning trips. returns detailed information including ratings, reviews, photos, and traveler recommendations to help create amazing travel experiences and comprehensive itineraries. examples: query="things to do in paris" + ssrc="a" for attractions only query="best restaurants in tokyo" + ssrc="r" for restaurants only query="hotels in bali" + ssrc="h" + tripadvisor domain="tripadvisor.com"

Action Parameters

query
stringRequired
ssrc
string
tripadvisor_domain
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Walmart Product Search

Description

Search walmart for products with price filtering. this tool searches walmart's product catalog including groceries, electronics, clothing, home goods, pharmacy, and auto services. supports basic price range filtering for finding products within budget. perfect for finding everyday essentials, comparing walmart prices, and discovering walmart's full range of products and services. examples: query="wireless headphones" + min price=50 + max price=200 query="gaming laptop" + max price=800 query="organic coffee" + min price=10

Action Parameters

max_price
number
min_price
number
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired