> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Composio Search

> 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.

![Composio Search logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/composio_search.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=f2dc8d0ec2225f612106dea5cc67e816)

* **Category:** ai agents
* **Auth:** NO\_AUTH
* **Composio-managed OAuth available?** N/A
* **Tools:** 22
* **Triggers:** 0
* **Slug:** `COMPOSIO_SEARCH`
* **Version:** 20261101\_00

## Tools

> [accordion] Amazon Product Search
>
> **Slug:** `COMPOSIO_SEARCH_AMAZON`
>
> Search Amazon products across international marketplaces. Returns selected product details, including prices, ratings, review counts, and Prime status when available; supports pagination.
>
> #### Input Parameters
>
> **page** `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.
>
> **query** `string` *required*
>
> Product search query for Amazon. Use natural language or specific product names.
>
> **amazon\_domain** `string`
>
> Amazon marketplace domain based on country. Defaults to amazon.com. Different domains serve different countries and currencies.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio DuckDuckGo Search
>
> **Slug:** `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
>
> **query** `string` *required*
>
> The search query for the Composio DuckDuckGo Search API, specifying the search topic.
>
> **start** `integer`
>
> Result offset for pagination. Use multiples of the page size (typically 10-30) to retrieve subsequent pages of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Google Events Search
>
> **Slug:** `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. 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
>
> **gl** `string`
>
> Country code for the search region (ISO 3166-1 alpha-2). Determines which country's events to prioritize.
>
> **hl** `string`
>
> Language code for search interface and results (ISO 639-1). Controls the language of event descriptions and interface.
>
> **query** `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.
>
> **start** `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.
>
> **htichips** `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.
>
> **location** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Exa Answer
>
> **Slug:** `COMPOSIO_SEARCH_EXA_ANSWER`
>
> Get answers with citations using the Exa API. DEPRECATED: Use COMPOSIO\_SEARCH\_WEB instead.
>
> #### Input Parameters
>
> **content** `string` *required*
>
> The user message content for the Exa answer API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Similarlinks
>
> **Slug:** `COMPOSIO_SEARCH_EXA_SIMILARLINK`
>
> Find links similar to a supplied URL using Exa, with optional domain, date, category and result-count filters.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The url for which you would like to find similar links. For e.g. '[https://slatestarcodex.com/2014/07/30/meditations-on-moloch/](https://slatestarcodex.com/2014/07/30/meditations-on-moloch/)', '[https://ww.google.com/](https://ww.google.com/)'
>
> **type** `string`
>
> The type of search: 'keyword', 'neural', or 'magic'. For e.g. 'neural', 'keyword', 'magic'.
>
> **category** `string`
>
> A data category to focus on, with higher comprehensivity and data cleanliness. Categories right now include company, research paper, news, github, tweet, movie, song, personal site, and pdf
>
> **numResults** `integer`
>
> Number of search results to return. For e.g. 10, 20, 30.
>
> **endCrawlDate** `string`
>
> Results will include links crawled before this date. For e.g. '2023-01-01T00:00:00Z', '2023-01-15T00:00:00Z', '2023-02-01T00:00:00Z'.
>
> **useAutoprompt** `boolean`
>
> If true, your query will be converted to an Composio Similarlinks query. For e.g. True, False, True.
>
> **excludeDomains** `array`
>
> List of domains to exclude in the search. For e.g. \['example.com'], \['news.com'], \['blog.com'].
>
> **includeDomains** `array`
>
> List of domains to include in the search. For e.g. \['example.com'], \['news.com'], \['blog.com'].
>
> **startCrawlDate** `string`
>
> Results will include links crawled after this date. For e.g. '2023-01-01T00:00:00Z', '2023-01-15T00:00:00Z', '2023-02-01T00:00:00Z'.
>
> **endPublishedDate** `string`
>
> Only links published before this date will be returned. For e.g. '2023-01-01', '2023-01-15', '2023-02-01'.
>
> **startPublishedDate** `string`
>
> Only links published after this date will be returned. For e.g. '2023-01-01', '2023-01-15', '2023-02-01'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch URL Content
>
> **Slug:** `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
>
> **text** `boolean`
>
> Include extracted markdown text content from the page. Defaults to true.
>
> **urls** `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.
>
> **extras** `object`
>
> Additional content options like imageLinks or links counts (e.g., \{'imageLinks': 3, 'links': 5}).
>
> **summary** `string`
>
> Include AI-generated summary of the page content. Can be boolean or object with query/schema options.
>
> **max\_characters** `integer`
>
> Maximum number of characters to extract from each page. Maps to text.maxCharacters in Exa API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Finance Search
>
> **Slug:** `COMPOSIO_SEARCH_FINANCE`
>
> Search 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
>
> **hl** `string`
>
> Language code for financial interface and data (ISO 639-1). Defaults to English if unset; set explicitly for non-English locales.
>
> **query** `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.
>
> **window** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Flight Search
>
> **Slug:** `COMPOSIO_SEARCH_FLIGHTS`
>
> Search 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
>
> **gl** `string`
>
> Country code for results (ISO 3166-1 alpha-2).
>
> **hl** `string`
>
> Language code for results (ISO 639-1).
>
> **query** `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.
>
> **adults** `integer`
>
> Number of adult passengers (18+ years old).
>
> **infants** `integer`
>
> Number of infant passengers (under 2 years old).
>
> **children** `integer`
>
> Number of child passengers (2-11 years old).
>
> **currency** `string`
>
> Currency for pricing (3-letter currency code).
>
> **arrival\_id** `string`
>
> Destination airport IATA code (3-letter uppercase code, e.g., SFO, LHR, CDG). Required if 'query' is not provided.
>
> **return\_date** `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.
>
> **departure\_id** `string`
>
> Origin airport IATA code (3-letter uppercase code, e.g., JFK, LAX, LHE). Required if 'query' is not provided.
>
> **travel\_class** `integer`
>
> Travel class preference. 1 = Economy, 2 = Premium Economy, 3 = Business, 4 = First Class.
>
> **outbound\_date** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Google Maps Search
>
> **Slug:** `COMPOSIO_SEARCH_GOOGLE_MAPS`
>
> Search 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
>
> **q** `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.
>
> **ll** `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.
>
> **start** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Groq Chat Completion
>
> **Slug:** `COMPOSIO_SEARCH_GROQ_CHAT`
>
> Generate 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
>
> **model** `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.
>
> **top\_p** `number`
>
> Nucleus sampling parameter. Controls diversity by considering only the top P probability mass. Range: 0.0 to 1.0.
>
> **stream** `boolean`
>
> Whether to stream the response back incrementally or return it all at once.
>
> **messages** `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.
>
> **max\_tokens** `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.
>
> **temperature** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Hotel Search
>
> **Slug:** `COMPOSIO_SEARCH_HOTELS`
>
> Search 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
>
> **q** `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.
>
> **gl** `string`
>
> Country code for results (ISO 3166-1 alpha-2).
>
> **hl** `string`
>
> Language code for results (ISO 639-1).
>
> **adults** `integer`
>
> Number of adult guests.
>
> **sort\_by** `integer`
>
> Sort hotels by criteria. Valid values: 3 (lowest price), 8 (highest rating), 13 (most reviewed). Default is relevance.
>
> **children** `integer`
>
> Number of children.
>
> **currency** `string`
>
> Currency for pricing (3-letter currency code).
>
> **max\_price** `integer`
>
> Maximum price per night filter.
>
> **min\_price** `integer`
>
> Minimum price per night filter.
>
> **hotel\_class** `string`
>
> Filter by hotel star rating. Use comma-separated values for multiple ratings.
>
> **check\_in\_date** `string` *required*
>
> Check-in date in YYYY-MM-DD format. Must be a future date.
>
> **check\_out\_date** `string` *required*
>
> Check-out date in YYYY-MM-DD format. Must be after check-in date.
>
> **vacation\_rentals** `boolean`
>
> Include vacation rentals (Airbnb-style properties) in results.
>
> **free\_cancellation** `boolean`
>
> Filter for hotels with free cancellation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Image Search
>
> **Slug:** `COMPOSIO_SEARCH_IMAGE`
>
> Search 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
>
> **ijn** `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.
>
> **num** `integer`
>
> Number of image results to return. Defaults to 20 if not specified. Google typically returns up to 100 results.
>
> **query** `string` *required*
>
> The search query for the Composio Image Search API, specifying the image topic.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio News Search
>
> **Slug:** `COMPOSIO_SEARCH_NEWS`
>
> Search 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
>
> **gl** `string`
>
> Country code for news region (ISO 3166-1 alpha-2). Determines which country's news sources to prioritize.
>
> **hl** `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'.
>
> **when** `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.
>
> **query** `string`
>
> 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`
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] NPPES NPI Registry Lookup
>
> **Slug:** `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
>
> **city** `string`
>
> City name associated with provider address.
>
> **skip** `integer`
>
> Number of records to skip for pagination. Used with limit for paginated results.
>
> **limit** `integer`
>
> Maximum number of records to return per request. Range: 1 to 1200. Default: 10.
>
> **state** `string`
>
> Two-letter state abbreviation. Cannot be used as sole search criterion - must be combined with other parameters.
>
> **number** `string`
>
> 10-digit National Provider Identifier number for exact lookup. When provided, performs exact NPI match.
>
> **version** `string`
>
> API version number. Required by the CMS NPPES API.
>
> **last\_name** `string`
>
> Individual provider last name. Supports trailing wildcard (\*) after minimum 2 characters. Applies to Individual Providers (NPI-1) only.
>
> **first\_name** `string`
>
> Individual provider first name. Supports trailing wildcard (\*) after minimum 2 characters. Applies to Individual Providers (NPI-1) only.
>
> **postal\_code** `string`
>
> 5 or 9 digit postal code. Supports trailing wildcard (\*) after minimum 2 characters.
>
> **enumeration\_type** `string ("NPI-1" | "NPI-2" | "ind" | "org")`
>
> Provider classification type: 'NPI-1' or 'ind' for Individual providers, 'NPI-2' or 'org' for Organizational providers.
>
> **organization\_name** `string`
>
> Organization name for searching organizational providers. Supports trailing wildcard (\*) after minimum 2 characters.
>
> **taxonomy\_description** `string`
>
> Healthcare provider taxonomy description or specialty. Supports wildcard (\*) after minimum 2 characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Scholar Search
>
> **Slug:** `COMPOSIO_SEARCH_SCHOLAR`
>
> Search Google Scholar for scholarly articles. Returns normalized article details, including authors, citation counts, snippets and PDF links when available, with pagination information.
>
> #### Input Parameters
>
> **query** `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.
>
> **start** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio SEC EDGAR Filings Search
>
> **Slug:** `COMPOSIO_SEARCH_SEC_FILINGS`
>
> Retrieve 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
>
> **limit** `integer`
>
> Maximum number of filings to return. Defaults to 10.
>
> **form\_types** `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.
>
> **ticker\_or\_cik** `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.
>
> **include\_document\_links** `boolean`
>
> Whether to include filing document URLs (index page and primary document) for downstream reading. Defaults to true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Shopping Search
>
> **Slug:** `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. 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
>
> **gl** `string`
>
> Country code for shopping region (ISO 3166-1 alpha-2).
>
> **hl** `string`
>
> Language code for shopping interface (ISO 639-1).
>
> **query** `string` *required*
>
> Product search query. Use anything you would search for on Google Shopping.
>
> **on\_sale** `boolean`
>
> Filter to show only products that are currently on sale.
>
> **sort\_by** `integer`
>
> Sort products by price. 1 = Price: low to high, 2 = Price: high to low.
>
> **location** `string`
>
> Geographic location for shopping search. Use city names for best results. Helps find local retailers and pricing.
>
> **max\_price** `integer`
>
> Maximum price filter in USD (integer value). Only show products at or below this price.
>
> **min\_price** `integer`
>
> Minimum price filter in USD (integer value). Only show products at or above this price.
>
> **free\_shipping** `boolean`
>
> Filter to show only products with free shipping.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio LLM Search
>
> **Slug:** `COMPOSIO_SEARCH_TAVILY`
>
> Search 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
>
> **query** `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.
>
> **max\_results** `integer`
>
> 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 ("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.
>
> **include\_answer** `boolean`
>
> Specifies whether to include direct answers to the query in the search results. Useful for queries that expect a factual answer.
>
> **include\_images** `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.
>
> **exclude\_domains** `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.
>
> **include\_domains** `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.
>
> **include\_raw\_content** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Trends Search
>
> **Slug:** `COMPOSIO_SEARCH_TRENDS`
>
> Search Google Trends for interest over time, regional comparisons, related topics, and related queries. Results vary by data type; timeline values contain numeric extracted values, and a timeline point may be marked is\_partial.
>
> #### Input Parameters
>
> **date** `string`
>
> 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' (e.g., '2021-10-15 2022-05-25') or with hours 'yyyy-mm-ddThh yyyy-mm-ddThh' (e.g., '2022-05-19T10 2022-05-24T22'). Defaults to past 12 months if not specified. Windows longer than \~90 days aggregate data weekly, smoothing short-lived spikes; use shorter windows (e.g., 'now 7-d') alongside longer ones to detect brief surges.
>
> **query** `string` *required*
>
> 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 'Maximum number of queries accepted is 5'. Overly specific or multi-concept queries may return empty results (organic\_results\_state='Fully empty') — use concise single-concept keywords.
>
> **data\_type** `string`
>
> Parameter defines the type of search you want to do. Available options: TIMESERIES - Interest over time (default) - Accepts both single and multiple queries per search. GEO\_MAP - Compared breakdown by region - Accepts only multiple queries per search. GEO\_MAP\_0 - Interest by region - Accepts only single query per search. RELATED\_TOPICS - Related topics - Accepts only single query per search. RELATED\_QUERIES - Related queries - Accepts only single query per search. TIMESERIES accepts 1–5 comma-separated queries; GEO\_MAP\_0, RELATED\_TOPICS, and RELATED\_QUERIES accept only a single query — mismatching causes validation errors or empty results. Response schema differs per type; branch parsing logic accordingly. RELATED\_TOPICS/RELATED\_QUERIES with multi-term queries may silently fall back to TIMESERIES — verify results.search\_parameters.data\_type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] TripAdvisor Travel Search
>
> **Slug:** `COMPOSIO_SEARCH_TRIP_ADVISOR`
>
> Search 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
>
> **ssrc** `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.
>
> **limit** `integer`
>
> Maximum number of results to return per page. Controls how many results are returned in a single request.
>
> **query** `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.
>
> **offset** `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.
>
> **tripadvisor\_domain** `string`
>
> TripAdvisor domain for different countries. Defaults to tripadvisor.com for international results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Walmart Product Search
>
> **Slug:** `COMPOSIO_SEARCH_WALMART`
>
> Search 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
>
> **query** `string` *required*
>
> Product search query for Walmart. Use natural language or specific product names.
>
> **max\_price** `number`
>
> Maximum price filter in USD.
>
> **min\_price** `number`
>
> Minimum price filter in USD.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Composio Web Search
>
> **Slug:** `COMPOSIO_SEARCH_WEB`
>
> Search 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
>
> **query** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
