# SerpApi

SerpApi provides a real-time API for structured search engine results, allowing developers to scrape, parse, and analyze SERP data for SEO and research

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 48
- **Triggers:** 0
- **Slug:** `SERPAPI`
- **Version:** 20260413_01

## Tools

### Search Baidu with Query

**Slug:** `SERPAPI_BAIDU_SEARCH`

Search Baidu (Chinese search engine) and retrieve search results. Requires a search query string in the 'q' parameter. Returns organic search results, answer boxes, and pagination info in JSON format.

### Bing Maps Search

**Slug:** `SERPAPI_BING_MAPS`

Tool to scrape Bing Maps results using SerpApi. Use when you need to find local businesses, places, or get detailed location information including addresses, phone numbers, ratings, reviews, and more. Supports searching by query or specific place ID.

### Bing Search

**Slug:** `SERPAPI_BING_SEARCH`

Retrieve Bing Search Engine Results via SerpAPI (requires active SerpAPI connection; if unavailable, use COMPOSIO_SEARCH_WEB or COMPOSIO_SEARCH_NEWS). Consumes SerpAPI credits per call; throttle to ~1–2 calls/second and apply exponential backoff on HTTP 429. Supports query, location, language, and device parameters. Set `location`, `mkt`, or `cc` explicitly when local relevance matters — result ranking is highly sensitive to localization.

### DuckDuckGo Light Search

**Slug:** `SERPAPI_DUCK_DUCK_GO_LIGHT_SEARCH`

Tool to access the world's fastest DuckDuckGo Search API via SerpApi. Scrapes DuckDuckGo search results in JSON format with critical data for faster response times, without extra-rich results. Use when you need quick DuckDuckGo search results with essential information. Supports location-based searches, date filtering, and pagination (15 results per page).

### DuckDuckGo Maps search

**Slug:** `SERPAPI_DUCK_DUCK_GO_MAPS`

Scrapes DuckDuckGo Maps results via SerpApi. Use when searching for location-based information like businesses, restaurants, or services in a specific geographic area. Returns structured data including ratings, reviews, addresses, operating hours, and contact information.

### DuckDuckGo search

**Slug:** `SERPAPI_DUCK_DUCK_GO_SEARCH`

Performs a DuckDuckGo search via SerpApi to retrieve SERP data, including organic results, ads, and structured information. Requires a valid SerpApi connection configured in Composio. Results may be localized by region by default.

### eBay Search

**Slug:** `SERPAPI_EBAY_SEARCH`

Retrieve eBay Search Results via SerpApi (requires active SerpApi connected account). Supports parameters like nkw (query), location, etc. Returns product SERP data in JSON format. Listing prices and fees may be incomplete or inconsistent; verify total cost on the source page before comparing results.

### Search Google Events

**Slug:** `SERPAPI_EVENT_SEARCH`

Searches for events (e.g., concerts, festivals, conferences) by query, retrieving structured data from Google's event search results via the SerpApi Google Events engine.

### Search finance

**Slug:** `SERPAPI_FINANCE_SEARCH`

Retrieves structured financial information (e.g., company data, stock details, market trends, news) from Google Finance via SERP API based on a query. Requires active SerpApi credentials. Empty results for delisted, illiquid, or newly listed assets are valid 'no data' responses. High query volumes may trigger HTTP 429 rate limits; apply backoff on retries.

### Get Location Options

**Slug:** `SERPAPI_GET_AVAILABLE_LOCATION_OPTIONS_FOR_GOOGLE_SEARCHES`

Tool to get available location options for Google searches. Returns location names, codes, and identifiers that can be used in the location parameter. Use when you need to find valid location values for search queries.

### Get Facebook profile information

**Slug:** `SERPAPI_GET_FACEBOOK_PROFILE`

Tool to retrieve public information from a Facebook profile or page using SerpAPI. Use when you need to fetch profile details, bio, photos, followers, ratings, or contact information.

### Get Google About This Result

**Slug:** `SERPAPI_GET_GOOGLE_ABOUT_THIS_RESULT`

Tool to get Google 'About this result' information for a website. Use when you need detailed information about a specific URL including company details, social profiles, web citations, and reviews.

### Get Google Hotels Autocomplete

**Slug:** `SERPAPI_GET_GOOGLE_HOTELS_AUTOCOMPLETE_SUGGESTIONS`

Tool to get autocomplete suggestions for Google Hotels destination searches. Use when users need to search for hotel destinations, properties, or locations before performing a full hotel search.

### Get Google Images Related Content

**Slug:** `SERPAPI_GET_GOOGLE_IMAGES_RELATED_CONTENT`

Get related content for a specific Google Images result. Requires a related_content_id obtained from a Google Images search. Use when you need to find similar images or related visual content for a particular image.

### Get Google Patent Details

**Slug:** `SERPAPI_GET_GOOGLE_PATENT_DETAILS`

Tool to retrieve detailed information about a specific patent or scholar document from Google Patents via SerpApi. Use when you need patent details, claims, citations, inventors, assignees, legal events, or scholar publication information.

### Get Search Archive

**Slug:** `SERPAPI_GET_SEARCH_ARCHIVE`

Tool to retrieve results from a previous async search using its search ID. Use when you need to fetch results from searches submitted with async=true. Searches can be retrieved up to 31 days after completion.

### Google Domains List

**Slug:** `SERPAPI_GOOGLE_DOMAINS_LIST`

Retrieve the list of supported Google domains for search queries.

### Google Forums Search

**Slug:** `SERPAPI_GOOGLE_FORUMS_SEARCH`

Tool to scrape forum results from Google's Forums Platform using SerpApi. Use when you need to search forum discussions, get forum titles, dates, links, answers with voting data, and related searches.

### Google Jobs Search

**Slug:** `SERPAPI_GOOGLE_JOBS_SEARCH`

Retrieve Google Jobs Search Results via SerpApi. Returns job SERP data in JSON; key attributes like `work_from_home`, `posted_at`, `salary`, and `schedule_type` are nested under `detected_extensions` per job object and are often absent — treat as optional. Results may include stale postings; verify recency via `detected_extensions.posted_at`. Supports pagination, location filtering, and remote-job filtering.

### Google Lens search

**Slug:** `SERPAPI_GOOGLE_LENS_SEARCH`

Performs reverse image search using Google Lens to find visually similar images, products, and related content. Use when you need to identify objects, find similar products, or get information about images. Requires a publicly accessible image URL.

### Google Light Search

**Slug:** `SERPAPI_GOOGLE_LIGHT_SEARCH`

Retrieve Google Light Search Results via SerpApi. Requires an active SerpApi connection. Supports q, location, gl, hl, and other SERP parameters. Returns lightweight JSON SERP data; results are in organic_results (handle missing/empty gracefully). Snippets are shallow — follow citation URLs with BROWSER_TOOL_FETCH_WEBPAGE for full content. Rate limit: HTTP 429 under heavy use; keep to ~1–2 requests/sec with exponential backoff on retry.

### Google Maps Posts

**Slug:** `SERPAPI_GOOGLE_MAPS_POSTS`

Scrapes Google Maps Posts for a business location via SerpApi. Extracts local posts published by business owners including titles, descriptions, links, images, and publication dates. Returns 10 posts per page with pagination support.

### Google maps search

**Slug:** `SERPAPI_GOOGLE_MAPS_SEARCH`

Performs a Google Maps search via SERP API. Takes a query, optionally using specific GPS coordinates and pagination, returning structured location data.

### Google Play Product Search

**Slug:** `SERPAPI_GOOGLE_PLAY_PRODUCT`

Tool to retrieve detailed Google Play product information using SerpApi. Supports apps, movies, TV shows, audiobooks, and books. Use when you need product details, ratings, reviews, or media for Google Play Store items.

### Google Scholar Author Profile

**Slug:** `SERPAPI_GOOGLE_SCHOLAR_AUTHOR`

Scrapes full Google Scholar Author page including articles, citations, metrics, and co-authors. Use when you need detailed information about a specific researcher's publications and academic profile.

### Google Scholar Cite

**Slug:** `SERPAPI_GOOGLE_SCHOLAR_CITE`

Scrapes full Google Scholar Citations with multiple citation formats. Retrieves MLA, APA, Chicago, Harvard, and Vancouver style citations along with download links for BibTeX, EndNote, RefMan, and RefWorks. Use when you need formatted citations for a specific research paper identified by its Google Scholar ID.

### Google Videos Light Search

**Slug:** `SERPAPI_GOOGLE_VIDEOS_LIGHT`

Tool to scrape Google Videos results using SerpApi's ultra-fast Google Videos Light API. Use when you need video titles, links, thumbnails, snippets, upload dates, and durations from Google Videos search. This lighter version excludes rich results for faster response times.

### Hotel Search

**Slug:** `SERPAPI_HOTEL_SEARCH`

Retrieve Google Hotel Search Results. Supports parameters like q (query), location, etc. Returns hotel SERP data in JSON format.

### Image search

**Slug:** `SERPAPI_IMAGE_SEARCH`

Searches Google Images via SERP API for a given query, returning structured image results. Requires a valid SerpAPI authenticated connection. The number of results can be controlled using the 'num' parameter (1-100). If not specified, it defaults to 20 results.

### Naver Search

**Slug:** `SERPAPI_NAVER_SEARCH`

Tool to search Naver (South Korea's leading search engine) for Korean web results and content. Use when searching for Korean-language content, news, videos, images, or shopping results. Supports various search categories and filtering options including time periods and sorting.

### Search for news articles

**Slug:** `SERPAPI_NEWS_SEARCH`

Searches Google News (via SerpApi, `tbm=nws`) for articles matching a query; precise key-phrase queries yield best results. Auth is handled via SerpApi connection — do not pass api_key as a parameter. Results returned under `news_results` field (~10 items/page). Rate-limited: throttle to ~1 req/s; HTTP 429 on bursts — apply exponential backoff (1s, 2s, 4s). Covers news content only; pair with SERPAPI_SEARCH for broader web sources. Headlines/snippets only — use EXA_GET_CONTENTS_ACTION for full article text.

### OpenTable Reviews Search

**Slug:** `SERPAPI_OPEN_TABLE_REVIEWS`

Tool to scrape OpenTable restaurant reviews using SerpApi. Retrieves user reviews, ratings, restaurant responses, images, and AI-generated summaries. Use when you need detailed review data for OpenTable restaurants.

### Google Play Search

**Slug:** `SERPAPI_PLAY_SEARCH`

Retrieve Google Play Store Search Results. Supports parameters like q (query), gl, hl, etc. Returns app SERP data in JSON format.

### Search Google Scholar

**Slug:** `SERPAPI_SCHOLAR_SEARCH`

Searches Google Scholar via SerpApi for academic literature, papers, articles, and citations based on a query. Response results may include `inline_links.cited_by` and `resources` (PDF links), but these fields are not guaranteed; check for their existence and type before accessing.

### Serp API search

**Slug:** `SERPAPI_SEARCH`

Performs a real-time Google search via the SerpAPI connection (must be active; if unavailable, use COMPOSIO_SEARCH_WEB or other COMPOSIO_SEARCH_* tools). Returns ~10 organic results per page nested under results.organic_results — not a flat list; handle missing/empty arrays. Paginate via start offset or serpapi_pagination.next; max num=100; stop when domains plateau to avoid quota exhaustion. Rate-limited: throttle to 1–2 req/s; HTTP 429 on bursts — apply exponential backoff (1s, 2s, 4s). Derive result rank from array index (absolute rank = start + index; no explicit rank field). Lacks date-bound controls — embed recency terms in query or use SERPAPI_NEWS_SEARCH for time-sensitive queries. Results may include ads and sponsored content; prefer authoritative domains. Use vertical tools (SERPAPI_IMAGE_SEARCH, SERPAPI_NEWS_SEARCH, SERPAPI_YOU_TUBE_SEARCH, SERPAPI_GOOGLE_JOBS_SEARCH) for specialized query types.

### Search Apple App Store

**Slug:** `SERPAPI_SEARCH_APPLE_APP_STORE`

Tool to search Apple App Store for iOS and Mac apps. Returns app details including ratings, reviews, descriptions, and developer information. Use when you need to find apps on the Apple App Store or get information about specific apps.

### Google Images Light Search

**Slug:** `SERPAPI_SEARCH_GOOGLE_IMAGES_LIGHT`

Tool to scrape Google Images results using SerpApi's Google Images Light API. Use when you need fast image search with thumbnails, titles, sources, and original image URLs from Google Images. This lightweight version provides faster response times compared to the full Google Images API.

### Search Google Local Services

**Slug:** `SERPAPI_SEARCH_GOOGLE_LOCAL_SERVICES`

Search Google Local Services for service providers like electricians, plumbers, HVAC technicians, and more. Use when you need to find local service professionals with Google's guaranteed badge and verified business information.

### Search Yelp businesses

**Slug:** `SERPAPI_SEARCH_YELP`

Tool to search Yelp for businesses and places using SerpApi. Returns business listings with ratings, reviews, hours, contact information, and location details. Use when you need to find local businesses, restaurants, services, or read customer reviews.

### Shopping search

**Slug:** `SERPAPI_SHOPPING_SEARCH`

Searches Google Shopping via SerpAPI for a specific product, returning structured listings in results.shopping_results. Requires an active SerpAPI connection. Response fields such as rating, review_count, extracted_price, and extracted_old_price may be absent; null-check before ranking or computing discounts. Discount percentages in listings may reflect aggregate promotional claims, not per-item pricing.

### Google Trends search

**Slug:** `SERPAPI_TRENDS_SEARCH`

Fetches Google Trends data; returns relative 0–100 interest indices (not absolute volumes) meaningful only when comparing queries within the same request. The `query`'s format (single/multiple terms) must comply with the selected `data_type`.

### Walmart Product Reviews

**Slug:** `SERPAPI_WALMART_PRODUCT_REVIEWS`

Tool to scrape full Walmart product reviews using SerpApi's Walmart Product Reviews API. Retrieves ratings, review text, user information, and helpful votes for a specific product. Use when you need detailed customer feedback and sentiment analysis for Walmart products.

### Walmart Search

**Slug:** `SERPAPI_WALMART_SEARCH`

Retrieve Walmart Search Results. Supports parameters like query, location, store ID, etc. Returns product SERP data in JSON format.

### Yahoo Search

**Slug:** `SERPAPI_YAHOO_SEARCH`

Retrieve Yahoo! Search Engine Results. Supports query, location, language, and device parameters.

### Yahoo Videos Search

**Slug:** `SERPAPI_YAHOO_VIDEOS`

Scrape Yahoo! Videos results with position, title, thumbnail, link, preview, source, duration, date and more. Use when you need to search for video content on Yahoo! Videos.

### Yandex Images Search

**Slug:** `SERPAPI_YANDEX_IMAGES_SEARCH`

Tool to search Yandex Images for image results with advanced filters. Use when searching for images on Yandex with filters like size, color, type, or performing reverse image search.

### Yandex Search

**Slug:** `SERPAPI_YANDEX_SEARCH`

Retrieve Yandex Search Results. Supports parameters like text (query), location, etc. Returns SERP data in JSON format.

### YouTube Search

**Slug:** `SERPAPI_YOU_TUBE_SEARCH`

Retrieve YouTube Search Results. Supports parameters like search_query, location, etc. Returns video SERP data in JSON format.
