Skip to main content
Composio Search logo
  • Category: ai agents
  • Auth: NO_AUTH
  • Composio-managed OAuth available? N/A
  • Tools: 22
  • Triggers: 0
  • Slug: COMPOSIO_SEARCH
  • Version: 20261101_00

Tools

Slug: COMPOSIO_SEARCH_AMAZONSearch Amazon products across international marketplaces. Returns selected product details, including prices, ratings, review counts, and Prime status when available; supports pagination.

Input Parameters

integer
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.
string
required
Product search query for Amazon. Use natural language or specific product names.
string
Amazon marketplace domain based on country. Defaults to amazon.com. Different domains serve different countries and currencies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_DUCK_DUCK_GOThe 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

string
required
The search query for the Composio DuckDuckGo Search API, specifying the search topic.
integer
Result offset for pagination. Use multiples of the page size (typically 10-30) to retrieve subsequent pages of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_EVENTSearch 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. Rate limit: ~2 requests/second; apply exponential backoff (1s, 2s, 4s) on 429 errors. Examples: “Tech conferences” in “San Francisco, CA” with gl=“us” and hl=“en” | “Virtual networking events” with htichips=“event_type:Virtual-Event,date:next_week” | “Music festivals” in “London, UK” with gl=“uk” and hl=“en”

Input Parameters

string
Country code for the search region (ISO 3166-1 alpha-2). Determines which country’s events to prioritize.
string
Language code for search interface and results (ISO 639-1). Controls the language of event descriptions and interface.
string
required
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.
integer
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.
string
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. Relative date values (e.g., ‘today’, ‘tomorrow’) resolve against UTC, so account for timezone offset near midnight.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_EXA_ANSWERGet answers with citations using the Exa API. DEPRECATED: Use COMPOSIO_SEARCH_WEB instead.

Input Parameters

string
required
The user message content for the Exa answer API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_FETCH_URL_CONTENTFetch 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

boolean
Include extracted markdown text content from the page. Defaults to true.
array
required
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.
object
Additional content options like imageLinks or links counts (e.g., {‘imageLinks’: 3, ‘links’: 5}).
string
Include AI-generated summary of the page content. Can be boolean or object with query/schema options.
integer
Maximum number of characters to extract from each page. Maps to text.maxCharacters in Exa API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_FINANCESearch Google Finance for stock quotes, indices, cryptocurrency prices, exchange rates, company financials and related news. Results may include a summary, historical price graph and key events; empty results can include an explanatory message.

Input Parameters

string
Language code for financial interface and data (ISO 639-1). Defaults to English if unset; set explicitly for non-English locales.
string
required
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), ’.IXIC:INDEXNASDAQ’ (NASDAQ Composite) - common names like ‘Dow Jones’, ‘S&P 500’, ‘NASDAQ’ are auto-converted. (3) Cryptocurrencies: ‘SYMBOL-USD’ format (e.g., ‘BTC-USD’, ‘ETH-USD’). (4) Currency pairs: ‘BASE-QUOTE’ format (e.g., ‘EUR-USD’, ‘GBP-USD’). (5) ETFs: ticker symbol (e.g., ‘SPY’, ‘QQQ’). Use exact ticker formats only — natural-language names or ambiguous strings cause empty results even on success. Currency pairs require hyphens (EUR-USD not EUR/USD). Crypto must use SYMBOL-USD format; bare symbols may return wrong instrument type. Commodities (e.g., GOLD) may not resolve; use ETF proxies (e.g., GLD) instead.
string
Time range for financial charts and data. Controls the historical period displayed. Only the listed discrete values are accepted; arbitrary values are unsupported. Key events (earnings, dividends, splits) are only returned for windows of 6M or longer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_FLIGHTSSearch flights using a natural-language route or structured airport codes and dates. Supports one-way and round-trip searches, passenger types, travel classes and currencies; an omitted departure date defaults to seven days from today.

Input Parameters

string
Country code for results (ISO 3166-1 alpha-2).
string
Language code for results (ISO 639-1).
string
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. You can also provide structured parameters directly instead.
integer
Number of adult passengers (18+ years old).
integer
Number of infant passengers (under 2 years old).
integer
Number of child passengers (2-11 years old).
string
Currency for pricing (3-letter currency code).
string
Destination airport IATA code (3-letter uppercase code, e.g., SFO, LHR, CDG). Required if ‘query’ is not provided.
string
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.
string
Origin airport IATA code (3-letter uppercase code, e.g., JFK, LAX, LHE). Required if ‘query’ is not provided.
integer
Travel class preference. 1 = Economy, 2 = Premium Economy, 3 = Business, 4 = First Class.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_GOOGLE_MAPSSearch Google Maps for places by query, optionally using map coordinates and a pagination offset. Results can include local places with addresses, coordinates, ratings, hours and contact information when available.

Input Parameters

string
required
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.
string
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; shift coordinates across adjacent viewports to cover nearby areas.
integer
Used for pagination. Each page returns ~20 local_results; increment start by 20 and follow serpapi_pagination.next tokens to retrieve subsequent pages. Omitting pagination silently misses results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_GROQ_CHATGenerate chat completions using Groq models for tasks such as question answering, content generation, coding, summarization and translation. If the selected model is rate-limited, the tool tries other models.

Input Parameters

string ("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")
The Groq model to use for inference. Different models offer different capabilities, speeds, and context windows.
number
Nucleus sampling parameter. Controls diversity by considering only the top P probability mass. Range: 0.0 to 1.0.
boolean
Whether to stream the response back incrementally or return it all at once.
array
required
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 to avoid crowding out user content. Pre-summarize lengthy inputs into short bullets to stay within the model’s context window and avoid silent truncation.
integer
The maximum number of tokens to generate in the response. If not specified, the model will generate up to its natural stopping point. For large outputs, set this high enough and check finish_reason in the response; if finish_reason is ‘length’, the output was truncated — generate large content in section-level chunks and stitch results.
number
Controls randomness in the output. Lower values (e.g., 0.2) make output more focused and deterministic, while higher values (e.g., 1.5) make it more creative and random. Range: 0.0 to 2.0. For structured, analytic, or predictive tasks use 0.5–0.8; high values produce inconsistent patterns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_HOTELSSearch hotels and vacation rentals by location and stay dates, with price, class, cancellation and localization filters. Results may include properties and ads with rates, ratings and booking information.

Input Parameters

string
required
Location for hotel search. Can be city, neighborhood, landmark, or specific hotel name. If search_information.total_results is very low, broaden by adding state, region, or country to reduce ambiguity.
string
Country code for results (ISO 3166-1 alpha-2).
string
Language code for results (ISO 639-1).
integer
Number of adult guests.
integer
Sort hotels by criteria. Valid values: 3 (lowest price), 8 (highest rating), 13 (most reviewed). Default is relevance.
integer
Number of children.
string
Currency for pricing (3-letter currency code).
integer
Maximum price per night filter.
integer
Minimum price per night filter.
string
Filter by hotel star rating. Use comma-separated values for multiple ratings.
string
required
Check-in date in YYYY-MM-DD format. Must be a future date.
string
required
Check-out date in YYYY-MM-DD format. Must be after check-in date.
boolean
Include vacation rentals (Airbnb-style properties) in results.
boolean
Filter for hotels with free cancellation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_IMAGESearch Google Images for image metadata and URLs, including original and thumbnail links. Control the number of returned images and use an image page number to retrieve additional pages; license details may be available.

Input Parameters

integer
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.
integer
Number of image results to return. Defaults to 20 if not specified. Google typically returns up to 100 results.
string
required
The search query for the Composio Image Search API, specifying the image topic.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_NEWSSearch Google News results by query, time window, country and language. Returns filtered news articles, the displayed query and a flag indicating whether results were found; use the result offset to request another page.

Input Parameters

string
Country code for news region (ISO 3166-1 alpha-2). Determines which country’s news sources to prioritize.
string
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). Standalone ‘zh’ is normalized to ‘zh-cn’.
string
Time filter for news articles. ‘d’ = past day, ‘w’ = past week, ‘m’ = past month, ‘y’ = past year. These are coarse UTC-based buckets with no finer granularity; filter published_at client-side for precise ranges. Combining narrow queries with strict when filters frequently returns zero results; broaden either before concluding no data exists.
string
Search query for news articles. Supports advanced operators like ‘site:’, ‘when:’, etc. Cannot be used with topic_token, publication_token, or story_token.
integer
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_NPPESNPI_LOOKUPLookup 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_SCHOLARSearch Google Scholar for scholarly articles. Returns normalized article details, including authors, citation counts, snippets and PDF links when available, with pagination information.

Input Parameters

string
required
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.
integer
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_SEC_FILINGSRetrieve recent SEC EDGAR filing metadata for a company by ticker or CIK, optionally filtering by form type and constructing primary document and index URLs. The returned filing count reflects the limited results returned.

Input Parameters

integer
Maximum number of filings to return. Defaults to 10.
array
List of SEC form types to filter by (e.g., [‘10-K’, ‘10-Q’, ‘8-K’]). If not specified, all form types are returned.
string
required
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.
Whether to include filing document URLs (index page and primary document) for downstream reading. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_SHOPPINGSearch 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. Perfect for product research, price comparison, finding deals, and discovering where to buy items. Returns product details, prices, availability, seller information, and reviews. Examples: query=“gaming laptop” + min_price=800 + max_price=1500 + sort_by=1 query=“running shoes” + location=“Seattle, WA” + free_shipping=True query=“coffee maker” + on_sale=True + gl=“us”

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_TAVILYSearch a broad range of content using the Tavily API, with options for search depth, images, direct answers, domain filters, and the number of results.

Input Parameters

string
required
The primary text used to perform the search. This is the key term or phrase that the search functionality will use to retrieve results.
integer
The maximum number of search results that the API should return. This limits the size of the result set for the query.
string ("basic" | "advanced")
Determines the thoroughness of the search. A ‘basic’ search might perform a quick and broad search, while ‘advanced’ could indicate a more intensive and narrow search.
boolean
Specifies whether to include direct answers to the query in the search results. Useful for queries that expect a factual answer.
boolean
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.
array
A list of domain names to exclude from the search results. Results from these domains will not be included, which can help to filter out unwanted content.
array
A list of domain names to include in the search results. Only results from these specified domains will be returned, allowing for targeted searches.
boolean
If set to true, the search results will include the raw content from the search index, which may contain unprocessed HTML or text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_TRIP_ADVISORSearch TripAdvisor for attractions, restaurants, hotels, tours, and other travel information without a connected TripAdvisor account. Results may include places, locations, or forums, with optional ratings, review excerpts, and thumbnails; filter by result type and paginate.

Input Parameters

string ("a" | "r" | "A" | "h" | "g" | "v" | "f")
Search filter to specify result type. ‘a’ = All Results, ‘r’ = Restaurants, ‘A’ = Things to Do, ‘h’ = Hotels, ‘g’ = Destinations, ‘v’ = Vacation Rentals, ‘f’ = Forums.
integer
Maximum number of results to return per page. Controls how many results are returned in a single request.
string
required
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. Ambiguous queries may return multiple location matches — validate both title and location fields before selecting a result.
integer
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.
string
TripAdvisor domain for different countries. Defaults to tripadvisor.com for international results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_WALMARTSearch Walmart products with optional minimum and maximum price filters. Product listings appear in results.organic_results and may include prices, ratings, and sponsorship status.

Input Parameters

string
required
Product search query for Walmart. Use natural language or specific product names.
number
Maximum price filter in USD.
number
Minimum price filter in USD.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COMPOSIO_SEARCH_WEBSearch the web using Exa’s answer API, returning an AI-generated answer and source citations. The tool accepts a query without a separate date filter; verify source dates when recency matters.

Input Parameters

string
required
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; excessive site: or quoted-term filters can return zero results. Add disambiguating terms (city, role, domain) when searching for people or organizations with common names.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not