Composio Search

Overview

Composio Search is a comprehensive search platform that aggregates results from travel (flights, hotels, events), e-commerce (Amazon, Walmart, shopping), financial markets, news, academic research, images, and location services. With the integration in SquadOS, your agents can perform real-time web searches, compare prices across multiple stores, query financial data, search academic articles, and much more — all without configuring external API keys.

• Composio documentation: docs.composio.dev/toolkits/composio_search

Authentication

This tool uses no authentication (NO_AUTH) to connect.

Field	Required	Description
N/A	No	This tool does not require credentials.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Composio Search.
3. Click the card to open the details and hit Activate — the tool goes directly to the active list, with no login step. (Connection-flow details in Organization Tools.)

Available actions

Amazon Product Search

COMPOSIO_SEARCH_AMAZON

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.

Input parameters

Name	Type	Required	Description
page	integer	No	Page number for pagination. Starts at 1. Each page typically contains ~20 results. Use this to retrieve additional pages of results beyond the first page.
query	string	Yes	Product search query for Amazon. Use natural language or specific product names.
amazon_domain	string	No	Amazon marketplace domain based on country. Defaults to amazon.com. Different domains serve different countries and currencies.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio DuckDuckGo Search

COMPOSIO_SEARCH_DUCK_DUCK_GO

The DuckDuckGoSearch class utilizes the Composio DuckDuckGo Search API to perform searches, focusing on web information and details. It leverages the DuckDuckGo search engine via the Composio DuckDuckGo Search API to retrieve relevant web data based on the provided query.

Input parameters

Name	Type	Required	Description
query	string	Yes	The search query for the Composio DuckDuckGo Search API, specifying the search topic.
start	integer	No	Result offset for pagination. Use multiples of the page size (typically 10–30) to retrieve subsequent pages of results.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Google Events Search

COMPOSIO_SEARCH_EVENT

Search for upcoming events, concerts, festivals, conferences, and other activities. Supports location-based search (city, neighborhood, address), date filtering (today, tomorrow, weekend, next week/month), virtual event discovery, international search with 100+ languages and countries, and pagination. If results are sparse or events_results_state is 'Fully empty', treat as limited coverage and try COMPOSIO_SEARCH_WEB instead of retrying.

Input parameters

Name	Type	Required	Description
gl	string	No	Country code for the search region (ISO 3166-1 alpha-2). Determines which country’s events to prioritize.
hl	string	No	Language code for search interface and results (ISO 639-1). Controls the language of event descriptions and interface.
query	string	Yes	The search query for events, specifying the event topic. Must be non-empty and include a specific event type (e.g., ‘concert’, ‘festival’); empty or overly generic values like ‘events’ may trigger ‘Invalid parameters’ errors or return noisy results.
start	integer	No	Result offset for pagination. Each page typically contains 10 results. Use multiples of 10 for page navigation. Stop paginating when a page returns no new items to avoid unbounded loops on sparse results.
htichips	string	No	Advanced event filters. Multiple filters can be combined with commas for precise event discovery. Only the listed date and event_type values are supported; unsupported or arbitrary values silently return no results.
location	string	No	Geographic location to search for events. Use city-level specificity for best results. If omitted, search uses proxy location. Avoid ‘City, Country’ format — use just city names.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Exa Answer

COMPOSIO_SEARCH_EXA_ANSWER

Get answers with citations using the Exa API. DEPRECATED: Use COMPOSIO_SEARCH_WEB instead.

Input parameters

Name	Type	Required	Description
content	string	Yes	The user message content for the Exa answer API.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Similarlinks

COMPOSIO_SEARCH_EXA_SIMILARLINK

Perform a search to find similar links and retrieve a list of relevant results. The search can optionally return contents.

Input parameters

Name	Type	Required	Description
url	string	Yes	The url for which you would like to find similar links. For e.g. 'https://slatestarcodex.com/2014/07/30/meditations-on-moloch/'.
type	string	No	The type of search: 'keyword', 'neural', or 'magic'.
category	string	No	A data category to focus on, with higher comprehensivity and data cleanliness. Categories include: company, research paper, news, github, tweet, movie, song, personal site, and pdf.
numResults	integer	No	Number of search results to return. For e.g. 10, 20, 30.
endCrawlDate	string	No	Results will include links crawled before this date. For e.g. '2023-01-01T00:00:00Z'.
useAutoprompt	boolean	No	If true, your query will be converted to a Composio Similarlinks query.
excludeDomains	array	No	List of domains to exclude in the search. For e.g. ['example.com'].
includeDomains	array	No	List of domains to include in the search. For e.g. ['example.com'].
startCrawlDate	string	No	Results will include links crawled after this date. For e.g. '2023-01-01T00:00:00Z'.
endPublishedDate	string	No	Only links published before this date will be returned. For e.g. '2023-01-01'.
startPublishedDate	string	No	Only links published after this date will be returned. For e.g. '2023-01-01'.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Fetch URL Content

COMPOSIO_SEARCH_FETCH_URL_CONTENT

Fetch and extract clean, readable page text (markdown) from public web pages (HTML content) using the Exa API. Use when you need to retrieve actual content from search results or documentation links to extract setup steps, requirements, or citations. Only works with web page URLs — does not support direct links to images, PDFs, or other binary files.

Input parameters

Name	Type	Required	Description
text	boolean	No	Include extracted markdown text content from the page. Defaults to true.
urls	array	Yes	List of public URLs to web pages (HTML content) to fetch content from. URLs must be valid and publicly accessible. Do not use direct links to images (.jpg, .png, .gif), PDFs, or other binary files — use web page URLs only. Also accepts a single URL string.
extras	object	No	Additional content options like imageLinks or links counts (e.g., {'imageLinks': 3, 'links': 5}).
summary	string	No	Include AI-generated summary of the page content. Can be boolean or object with query/schema options.
max_characters	integer	No	Maximum number of characters to extract from each page. Maps to text.maxCharacters in Exa API.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Finance Search

COMPOSIO_SEARCH_FINANCE

Get real-time stock prices, market data, financial news, and company information with historical analysis. Retrieves stock quotes, market indices, cryptocurrency prices, exchange rates, and financial news. Supports discrete time windows (1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX) for historical analysis. Returns numeric time-series graph data, summary information, and key events (6M+ windows only). Always verify finance_results_state in the response — HTTP 200 with status='Success' can still return empty data. Derived indicators (MACD, moving averages) are not included and must be computed from returned price series.

Input parameters

Name	Type	Required	Description
hl	string	No	Language code for financial interface and data (ISO 639-1). Defaults to English if unset; set explicitly for non-English locales.
query	string	Yes	Financial search query. Supported formats: (1) Stocks: 'SYMBOL:EXCHANGE' (e.g., 'AAPL:NASDAQ', 'WMT:NYSE') or just 'SYMBOL' for major US stocks. (2) Indices: '.DJI:INDEXDJX' (Dow Jones), '.INX:INDEXSP' (S&P 500). (3) Cryptocurrencies: 'SYMBOL-USD' format (e.g., 'BTC-USD'). (4) Currency pairs: 'BASE-QUOTE' format (e.g., 'EUR-USD'). (5) ETFs: ticker symbol (e.g., 'SPY'). Use exact ticker formats only — natural-language names cause empty results.
window	string	No	Time range for financial charts and data. Controls the historical period displayed. Only the listed discrete values are accepted. Key events are only returned for windows of 6M or longer.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Flight Search

COMPOSIO_SEARCH_FLIGHTS

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. You can use either natural language queries or structured parameters.

Input parameters

Name	Type	Required	Description
gl	string	No	Country code for results (ISO 3166-1 alpha-2).
hl	string	No	Language code for results (ISO 639-1).
query	string	No	Natural language flight search query. Examples: 'Lahore to San Francisco', 'NYC to London on March 15', 'flights from Tokyo to Paris'. If provided, the system will parse this to extract departure/arrival airports and dates.
adults	integer	No	Number of adult passengers (18+ years old).
infants	integer	No	Number of infant passengers (under 2 years old).
children	integer	No	Number of child passengers (2–11 years old).
currency	string	No	Currency for pricing (3-letter currency code).
arrival_id	string	No	Destination airport IATA code (3-letter uppercase code, e.g., SFO, LHR, CDG). Required if query is not provided.
return_date	string	No	Return date in YYYY-MM-DD format. Must not be in the past and must be after outbound_date. Leave empty for one-way flights.
departure_id	string	No	Origin airport IATA code (3-letter uppercase code, e.g., JFK, LAX, LHE). Required if query is not provided.
travel_class	integer	No	Travel class preference. 1 = Economy, 2 = Premium Economy, 3 = Business, 4 = First Class.
outbound_date	string	No	Departure date in YYYY-MM-DD format (e.g., 2025-12-25). Must not be in the past. If not provided and query doesn’t contain a date, defaults to 7 days from today.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Google Maps Search

COMPOSIO_SEARCH_GOOGLE_MAPS

Performs a location-specific search via the Composio Google Maps Search API, returning results under results.local_results (multi-place queries) or results.place_results (single place); always handle both branches. Fields like opening_hours, phone, rating, and user_reviews may be absent — treat missing values as unknown. Check business_status: closed businesses (CLOSED_PERMANENTLY, TEMPORARILY_CLOSED) can appear in results; filter for OPERATIONAL entries. Rate-limit calls to ~1 req/sec; HTTP 429 / OVER_QUERY_LIMIT indicates quota exhaustion.

Input parameters

Name	Type	Required	Description
q	string	Yes	The query you want to search. Include city/region and category to avoid ambiguous or wrong-region results (e.g., 'pizza downtown Chicago' not 'pizza'). Verify name and full address before selecting a result.
ll	string	No	GPS coordinates for the search, formatted as '@latitude,longitude,zoom_level'. Required when using pagination. Results are limited to the visible map viewport defined by these coordinates.
start	integer	No	Used for pagination. Each page returns ~20 local_results; increment start by 20 and follow serpapi_pagination.next tokens to retrieve subsequent pages.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Groq Chat Completion

COMPOSIO_SEARCH_GROQ_CHAT

Execute fast LLM inference using Groq’s optimized hardware and API. Groq provides ultra-fast inference for open-source models including LLaMA 3, Mixtral, and Gemma via OpenAI-compatible chat completions API. Use cases: real-time chat, content generation, Q&A, code generation, summarization, translation. For structured JSON output, instruct the model explicitly to return valid JSON with no markdown code fences or prose; validate with json.loads. Always validate that the response contains at least one choice with non-empty message.content before downstream use.

Input parameters

Name	Type	Required	Description
model	string	No	The Groq model to use for inference. Available models: "llama-3.3-70b-versatile", "llama-3.1-8b-instant", "llama-3.2-1b-preview", "llama-3.2-3b-preview", "llama-3.2-11b-text-preview", "llama-3.2-90b-text-preview", "mixtral-8x7b-32768", "gemma2-9b-it", "gemma-7b-it", "openai/gpt-oss-120b", "groq/compound".
top_p	number	No	Nucleus sampling parameter. Controls diversity by considering only the top P probability mass. Range: 0.0 to 1.0.
stream	boolean	No	Whether to stream the response back incrementally or return it all at once.
messages	array	Yes	An array of message objects that form the conversation history. Each message must have a role (system, user, or assistant) and content. Place persona and system instructions in a role:'system' message; keep system messages concise.
max_tokens	integer	No	The maximum number of tokens to generate in the response. If finish_reason is 'length', the output was truncated — generate large content in section-level chunks and stitch results.
temperature	number	No	Controls randomness in the output. Lower values (e.g., 0.2) make output more focused and deterministic; higher values (e.g., 1.5) make it more creative. Range: 0.0 to 2.0.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Hotel Search

COMPOSIO_SEARCH_HOTELS

Search for hotels and vacation rentals with comprehensive filtering and pricing. Returns results under results.properties and results.ads; extract numeric pricing from rate_per_night.extracted_lowest, total_rate.extracted_lowest, or extracted_price (fields vary by property). Deduplicate across sections using property_token. Additional pages available via serpapi_pagination.next_page_token. Start with minimal filters — combining too many strict filters can return empty results.

Input parameters

Name	Type	Required	Description
q	string	Yes	Location for hotel search. Can be city, neighborhood, landmark, or specific hotel name.
gl	string	No	Country code for results (ISO 3166-1 alpha-2).
hl	string	No	Language code for results (ISO 639-1).
adults	integer	No	Number of adult guests.
sort_by	integer	No	Sort hotels by criteria. Valid values: 3 (lowest price), 8 (highest rating), 13 (most reviewed). Default is relevance.
children	integer	No	Number of children.
currency	string	No	Currency for pricing (3-letter currency code).
max_price	integer	No	Maximum price per night filter.
min_price	integer	No	Minimum price per night filter.
hotel_class	string	No	Filter by hotel star rating. Use comma-separated values for multiple ratings.
check_in_date	string	Yes	Check-in date in YYYY-MM-DD format. Must be a future date.
check_out_date	string	Yes	Check-out date in YYYY-MM-DD format. Must be after check-in date.
vacation_rentals	boolean	No	Include vacation rentals (Airbnb-style properties) in results.
free_cancellation	boolean	No	Filter for hotels with free cancellation.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Image Search

COMPOSIO_SEARCH_IMAGE

The ImageSearch class performs an image search using the Composio Image Search API, targeting image metadata and URLs (not binary data) via Google Images. Returns results under results.images_results; each entry exposes original (full resolution) and thumbnail (low resolution) URLs — verify URLs are publicly accessible before passing downstream. Check license_details_url per result before commercial reuse. The number of results is controlled by num (1–100, default 20). For >100 images, paginate using serpapi_pagination.next.

Input parameters

Name	Type	Required	Description
ijn	integer	No	Image page number for pagination. Starts at 0 (first page). Each page returns up to 100 results. Use incrementing values (0, 1, 2, …) to retrieve additional pages.
num	integer	No	Number of image results to return. Defaults to 20 if not specified. Google typically returns up to 100 results.
query	string	Yes	The search query for the Composio Image Search API, specifying the image topic.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio News Search

COMPOSIO_SEARCH_NEWS

Search for the latest news articles and current events with smart filtering. Searches news-oriented sources only (not blogs, docs, or company pages). Results nest under data.results.news_results; a 200 response with empty news_results or news_results_state: 'Fully empty' means no results — broaden query or when window. Supports 100+ languages and countries. Use advanced operators like 'site:' for publisher filtering directly in your query.

Input parameters

Name	Type	Required	Description
gl	string	No	Country code for news region (ISO 3166-1 alpha-2). Determines which country’s news sources to prioritize.
hl	string	No	Language code for news interface and results. Most languages use ISO 639-1 codes (e.g., 'en', 'es'). Chinese requires regional variants: 'zh-cn' (Simplified) or 'zh-tw' (Traditional).
when	string	No	Time filter for news articles. 'd' = past day, 'w' = past week, 'm' = past month, 'y' = past year. Combining narrow queries with strict when filters frequently returns zero results.
query	string	No	Search query for news articles. Supports advanced operators like 'site:', 'when:', etc. Cannot be used with topic_token, publication_token, or story_token.
start	integer	No	Result offset for pagination. Each page typically contains 10 results. Use multiples of 10 (0, 10, 20, 30, …) to navigate pages.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

NPPES NPI Registry Lookup

COMPOSIO_SEARCH_NPPESNPI_LOOKUP

Lookup US healthcare provider details from the CMS NPI Registry (NPPES) using an NPI number or search filters. Returns normalized structured fields including provider name, taxonomy/specialty, addresses, identifiers, and endpoints. Use this for deterministic, authoritative provider lookups when you need structured NPI/NPPES data rather than noisy web search results.

Input parameters

Name	Type	Required	Description
city	string	No	City name associated with provider address.
skip	integer	No	Number of records to skip for pagination. Used with limit for paginated results.
limit	integer	No	Maximum number of records to return per request. Range: 1 to 1200. Default: 10.
state	string	No	Two-letter state abbreviation. Cannot be used as sole search criterion — must be combined with other parameters.
number	string	No	10-digit National Provider Identifier number for exact lookup. When provided, performs exact NPI match.
version	string	No	API version number. Required by the CMS NPPES API.
last_name	string	No	Individual provider last name. Supports trailing wildcard (*) after minimum 2 characters. Applies to Individual Providers (NPI-1) only.
first_name	string	No	Individual provider first name. Supports trailing wildcard (*) after minimum 2 characters. Applies to Individual Providers (NPI-1) only.
postal_code	string	No	5 or 9 digit postal code. Supports trailing wildcard (*) after minimum 2 characters.
enumeration_type	string	No	Provider classification type: 'NPI-1' or 'ind' for Individual providers, 'NPI-2' or 'org' for Organizational providers.
organization_name	string	No	Organization name for searching organizational providers. Supports trailing wildcard (*) after minimum 2 characters.
taxonomy_description	string	No	Healthcare provider taxonomy description or specialty. Supports wildcard (*) after minimum 2 characters.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Scholar Search

COMPOSIO_SEARCH_SCHOLAR

Scholar API scrapes Google Scholar search results via SERP API, returning academic papers and scholarly articles. Results are nested under results.organic_results; access this key explicitly and use defensive .get() patterns as fields like DOI, citation_count, and author may be absent. Many results are paywalled — rely on titles, abstracts, and snippets when full text is unavailable. Results may include duplicate preprint and journal versions of the same work — deduplicate by DOI or normalized title. Only the first page is returned by default; follow pagination.next for additional pages.

Input parameters

Name	Type	Required	Description
query	string	Yes	The search query for the Composio Scholar Search API, specifying the academic topic or paper title. Prefer short, focused keyphrases over long quoted phrases to avoid zero results. Include author names, field qualifiers, or year ranges to improve relevance and avoid topic drift.
start	integer	No	Result offset for pagination. Each page typically contains 10 results. Use multiples of 10 (0, 10, 20, 30, …) to navigate pages. Stop paginating when a page returns no new results.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio SEC EDGAR Filings Search

COMPOSIO_SEARCH_SEC_FILINGS

Retrieve authoritative SEC EDGAR filing metadata (10-K/10-Q/8-K etc.) and construct primary document/index URLs using SEC’s public data APIs. Use when you need to search for company financial filings, annual reports, quarterly reports, or other SEC-mandated disclosures.

Input parameters

Name	Type	Required	Description
limit	integer	No	Maximum number of filings to return. Defaults to 10.
form_types	array	No	List of SEC form types to filter by (e.g., ['10-K', '10-Q', '8-K']). If not specified, all form types are returned.
ticker_or_cik	string	Yes	Stock ticker symbol (e.g., 'AAPL', 'MSFT') or 10-digit Central Index Key (CIK). If a ticker is provided, it will be automatically resolved to CIK.
include_document_links	boolean	No	Whether to include filing document URLs (index page and primary document) for downstream reading. Defaults to true.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Shopping Search

COMPOSIO_SEARCH_SHOPPING

Search for products with advanced price filtering, location targeting, and deal discovery. This tool provides comprehensive product search with price range filtering, geographic targeting for local retailers, sorting by price (low to high, high to low), and filtering for free shipping or sale items. Returns product details, prices, availability, seller information, and reviews.

Input parameters

Name	Type	Required	Description
gl	string	No	Country code for shopping region (ISO 3166-1 alpha-2).
hl	string	No	Language code for shopping interface (ISO 639-1).
query	string	Yes	Product search query. Use anything you would search for on Google Shopping.
on_sale	boolean	No	Filter to show only products that are currently on sale.
sort_by	integer	No	Sort products by price. 1 = Price: low to high, 2 = Price: high to low.
location	string	No	Geographic location for shopping search. Use city names for best results. Helps find local retailers and pricing.
max_price	integer	No	Maximum price filter in USD (integer value). Only show products at or below this price.
min_price	integer	No	Minimum price filter in USD (integer value). Only show products at or above this price.
free_shipping	boolean	No	Filter to show only products with free shipping.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio LLM Search

COMPOSIO_SEARCH_TAVILY

The Composio LLM Search class serves as a gateway to the Composio LLM Search API, allowing users to perform searches across a broad range of content with multiple filtering options. It accommodates complex queries, including both keyword and phrase searches, with additional parameters to fine-tune the search results. This class enables a tailored search experience by allowing users to specify the search depth, include images and direct answers, apply domain-specific filters, and control the number of results returned.

Input parameters

Name	Type	Required	Description
query	string	Yes	The primary text used to perform the search. This is the key term or phrase that the search functionality will use to retrieve results.
max_results	integer	No	The maximum number of search results that the API should return. This limits the size of the result set for the query.
search_depth	string	No	Determines the thoroughness of the search. 'basic' performs a quick and broad search; 'advanced' indicates a more intensive and narrow search.
include_answer	boolean	No	Specifies whether to include direct answers to the query in the search results. Useful for queries that expect a factual answer.
include_images	boolean	No	A flag indicating whether to include images in the search results. When set to true, the response will contain image links related to the query.
exclude_domains	array	No	A list of domain names to exclude from the search results. Results from these domains will not be included.
include_domains	array	No	A list of domain names to include in the search results. Only results from these specified domains will be returned.
include_raw_content	boolean	No	If set to true, the search results will include the raw content from the search index, which may contain unprocessed HTML or text.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Trends Search

COMPOSIO_SEARCH_TRENDS

Discover trending topics, search patterns, and popularity data. Analyzes search interest over time, compares multiple topics, and identifies rising trends. Returns normalized 0–100 relative interest indices (not absolute search volumes) via interest_over_time.timeline_data. Data typically lags ~24–48 hours. Response schema varies by data_type: TIMESERIES returns timeline_data, GEO_MAP returns regional breakdowns, RELATED_TOPICS/RELATED_QUERIES return topic/query lists.

Input parameters

Name	Type	Required	Description
date	string	No	Time range for trend data. Predefined ranges: 'now 1-H' (past hour), 'now 4-H' (past 4 hours), 'now 1-d' (past day), 'now 7-d' (past 7 days), 'today 1-m' (past 30 days), 'today 3-m' (past 90 days), 'today 12-m' (past 12 months), 'today 5-y' (past 5 years), 'all' (2004 to present). Custom ranges: 'yyyy-mm-dd yyyy-mm-dd'. Defaults to past 12 months if not specified.
query	string	Yes	The search query for the Google Trends Search API, specifying the trend topic. For TIMESERIES, accepts up to 5 comma-separated topics (e.g., 'Python,JavaScript,Rust'); exceeding 5 returns an error.
data_type	string	No	Parameter defines the type of search. Available options: TIMESERIES — Interest over time (default); GEO_MAP — Compared breakdown by region; GEO_MAP_0 — Interest by region (single query); RELATED_TOPICS — Related topics (single query); RELATED_QUERIES — Related queries (single query).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

TripAdvisor Travel Search

COMPOSIO_SEARCH_TRIP_ADVISOR

Search TripAdvisor for travel recommendations and itinerary planning without authentication. Searches attractions, restaurants, hotels, tours, and activities. Returns detailed ratings, reviews, photos, and traveler recommendations. Response data is nested under results → locations. Results may include evergreen articles alongside specific venues; verify result type before use in itineraries.

Input parameters

Name	Type	Required	Description
ssrc	string	No	Search filter to specify result type. 'a' = All Results, 'r' = Restaurants, 'A' = Things to Do, 'h' = Hotels, 'g' = Destinations, 'v' = Vacation Rentals, 'f' = Forums.
limit	integer	No	Maximum number of results to return per page. Controls how many results are returned in a single request.
query	string	Yes	Search query for TripAdvisor. Use natural language to search for attractions, restaurants, hotels, or activities. Include destination name, region, and travel context for best results.
offset	integer	No	Result offset for pagination. Use to skip a number of results and retrieve the next page. Increment by the page size (typically 10–30) to navigate pages.
tripadvisor_domain	string	No	TripAdvisor domain for different countries. Defaults to tripadvisor.com for international results.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Walmart Product Search

COMPOSIO_SEARCH_WALMART

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. Results may appear under response.data.results.shopping_results or data.products — do not hardcode a single response shape. Results mix sponsored and organic listings; check ad/sponsorship flags when ranking.

Input parameters

Name	Type	Required	Description
query	string	Yes	Product search query for Walmart. Use natural language or specific product names.
max_price	number	No	Maximum price filter in USD.
min_price	number	No	Minimum price filter in USD.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Composio Web Search

COMPOSIO_SEARCH_WEB

Perform a web search using the Exa API. Returns a nested structure: narrative summary under results.answer, sources under results.citations (and optionally results.organic_results). Prioritize results.citations as primary evidence over results.answer, which can be vague. Only indexes publicly available content — no paywalled, login-gated, or private content. Throttle to ~1–2 requests/second; bursty queries trigger HTTP 429.

Input parameters

Name	Type	Required	Description
query	string	Yes	The search query for the Composio Exa API. Must be non-empty; using any other parameter name (e.g., 'q') causes an invalid-request error. Include qualifiers (year, region, platform, intent) for better results — broad queries return generic content.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.