# SerpApi — how to use (mcp.ai)

Connect your SerpApi account and use 48 tools for analytics straight from your AI agent. Connect with your own API key. SerpApi provides a real-time API for structured search engine results, allowing developers to scrape, parse, and analyze SERP data for SEO and research.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_serpapi?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `serpapi_baidu_search`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/serpapi`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/serpapi/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/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.
  - body: { f?: string, q: string, bs?: string, ct?: string, oq?: string, pn?: integer, q5?: string, q6?: string, rn?: integer, gpc?: string, async?: boolean, device?: string, output?: string, no_cache?: boolean }
- `POST https://api.mcp.ai/api/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.
  - body: { q: string, cp?: string, count?: integer, first?: integer, setlang?: string, no_cache?: boolean, place_id?: string }
- `POST https://api.mcp.ai/api/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
  - body: { q: string, cc?: string, mkt?: string, first?: integer, device?: string, filters?: string, location?: string, safeSearch?: string }
- `POST https://api.mcp.ai/api/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 whe
  - body: { q: string, df?: string, kl?: string, async?: boolean, output?: string, no_cache?: boolean, zero_trace?: boolean, next_page_token?: string }
- `POST https://api.mcp.ai/api/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 includin
  - body: { q: string, lat?: number, lon?: number, bbox?: string, strict_bbox?: integer }
- `POST https://api.mcp.ai/api/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 l
  - body: { query: string }
- `POST https://api.mcp.ai/api/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 
  - body: { gl?: string, hl?: string, nkw: string, num?: integer, page?: integer, device?: string, location?: string, ebay_domain?: string, ebay_buyer_country?: string, ebay_marketplace_id?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { query: string, start?: integer }
- `POST https://api.mcp.ai/api/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 result
  - body: { query: string }
- `POST https://api.mcp.ai/api/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 f
  - body: { q?: string, limit?: integer }
- `POST https://api.mcp.ai/api/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.
  - body: { no_cache?: boolean, profile_id: string }
- `POST https://api.mcp.ai/api/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.
  - body: { q: string, async?: boolean, engine?: string, output?: string, no_cache?: boolean, google_domain?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { q: string, gl?: string, hl?: string, async?: boolean, currency?: string, no_cache?: boolean }
- `POST https://api.mcp.ai/api/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 pa
  - body: { q?: string, gl?: string, hl?: string, async?: boolean, output?: string, no_cache?: boolean, related_content_id: string }
- `POST https://api.mcp.ai/api/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 even
  - body: { async?: boolean, output?: string, no_cache?: boolean, patent_id: string }
- `POST https://api.mcp.ai/api/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 com
  - body: { search_id: string }
- `POST https://api.mcp.ai/api/serpapi/google/domains/list` — Retrieve the list of supported Google domains for search queries.
- `POST https://api.mcp.ai/api/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.
  - body: { q: string, gl?: string, hl?: string, nfpr?: integer, uule?: string, start?: integer, device?: string, engine?: string, filter?: integer, output?: string, location?: string, no_cache?: boolean, async_req?: boolean, zero_trace?: boolean, json_restrictor?: string }
- `POST https://api.mcp.ai/api/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` 
  - body: { q: string, gl?: string, hl?: string, uds?: string, lrad?: integer, uule?: string, chips?: string, ltype?: integer, engine?: string, output?: string, location?: string, no_cache?: boolean, async_req?: boolean, zero_trace?: boolean, google_domain?: string, next_page_token?: string }
- `POST https://api.mcp.ai/api/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 i
  - body: { q?: string, hl?: string, url: string, type?: string, country?: string }
- `POST https://api.mcp.ai/api/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 org
  - body: { q: string, gl?: string, hl?: string, lr?: string, num?: integer, nfpr?: string, safe?: string, uule?: string, start?: integer, device?: string, engine?: string, filter?: string, output?: string, location?: string, no_cache?: boolean, zero_trace?: boolean, async_param?: boolean, google_domain?: string }
- `POST https://api.mcp.ai/api/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 
  - body: { data_id: string, no_cache?: boolean, next_page_token?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { q: string, ll?: string, start?: integer }
- `POST https://api.mcp.ai/api/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 Googl
  - body: { gl?: string, hl?: string, num?: integer, async?: boolean, store: string, engine?: string, output?: string, rating?: integer, sort_by?: integer, no_cache?: boolean, platform?: string, season_id?: string, product_id: string, all_reviews?: boolean, next_page_token?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { hl?: string, num?: integer, sort?: string, start?: integer, view_op?: string, no_cache?: boolean, author_id: string, citation_id?: string }
- `POST https://api.mcp.ai/api/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 Ref
  - body: { q: string, hl?: string, no_cache?: boolean }
- `POST https://api.mcp.ai/api/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 sea
  - body: { q: string, gl?: string, hl?: string, lr?: string, tbs?: string, nfpr?: integer, safe?: string, uule?: string, start?: integer, device?: string, engine?: string, filter?: integer, output?: string, location?: string, no_cache?: boolean, async_req?: boolean, zero_trace?: boolean, google_domain?: string, json_restrictor?: string }
- `POST https://api.mcp.ai/api/serpapi/hotel/search` — Retrieve Google Hotel Search Results. Supports parameters like q (query), location, etc. Returns hotel SERP data in JSON format.
  - body: { q: string, gl?: string, hl?: string, async?: boolean, adults?: integer, output?: string, rating?: integer, sort_by?: string, bedrooms?: integer, children?: integer, currency?: string, no_cache?: boolean, amenities?: string, bathrooms?: integer, max_price?: integer, min_price?: integer, zero_trace?: boolean, check_in_date: string, children_ages?: string, eco_certified?: boolean, check_out_date: string, property_token?: string, property_types?: string, special_offers?: boolean, next_page_token?: string, vacation_rentals?: boolean, free_cancellation?: boolean }
- `POST https://api.mcp.ai/api/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' pa
  - body: { num?: integer, query: string }
- `POST https://api.mcp.ai/api/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 vario
  - body: { num?: integer, page?: integer, async?: boolean, query: string, start?: integer, where?: string, device?: string, output?: string, period?: string, sort_by?: string, no_cache?: boolean }
- `POST https://api.mcp.ai/api/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.
  - body: { num?: integer, query: string, start?: integer }
- `POST https://api.mcp.ai/api/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 OpenTab
  - body: { page?: integer, async?: boolean, output?: string, no_cache?: boolean, place_id: string, zero_trace?: boolean, json_restrictor?: string, open_table_domain?: string }
- `POST https://api.mcp.ai/api/serpapi/play/search` — Retrieve Google Play Store Search Results. Supports parameters like q (query), gl, hl, etc. Returns app SERP data in JSON format.
  - body: { q?: string, hl?: string, age?: string, chart?: string, store?: string, engine?: string, output?: string, no_cache?: boolean, async_param?: boolean, store_device?: string, apps_category?: string, see_more_token?: string, next_page_token?: string, section_page_token?: string }
- `POST https://api.mcp.ai/api/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 the
  - body: { num?: integer, query: string, start?: integer }
- `POST https://api.mcp.ai/api/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 un
  - body: { query: string }
- `POST https://api.mcp.ai/api/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 g
  - body: { num?: integer, term: string, async?: boolean, device?: string, country?: string, language?: string, no_cache?: boolean, property?: string, category_id?: string }
- `POST https://api.mcp.ai/api/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 lig
  - body: { q: string, gl?: string, hl?: string, imgar?: string, imgsz?: string, start?: integer, device?: string, engine?: string, end_date?: string, location?: string, start_date?: string, image_color?: string, period_unit?: string, period_value?: integer, google_domain?: string }
- `POST https://api.mcp.ai/api/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 ver
  - body: { q: string, hl?: string, bid?: string, cid?: string, pid?: string, async?: boolean, output?: string, data_cid: string, job_type?: string, no_cache?: boolean, zero_trace?: boolean, json_restrictor?: string }
- `POST https://api.mcp.ai/api/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 business
  - body: { attrs?: string, start?: integer, sortby?: string, find_loc: string, no_cache?: boolean, find_desc: string, yelp_domain?: string }
- `POST https://api.mcp.ai/api/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_co
  - body: { num?: integer, query: string, start?: integer }
- `POST https://api.mcp.ai/api/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) 
  - body: { query: string, data_type?: string }
- `POST https://api.mcp.ai/api/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 d
  - body: { page?: integer, sort?: string, async?: boolean, output?: string, rating?: integer, no_cache?: boolean, product_id: string }
- `POST https://api.mcp.ai/api/serpapi/walmart/search` — Retrieve Walmart Search Results. Supports parameters like query, location, store ID, etc. Returns product SERP data in JSON format.
  - body: { q: string, page?: integer, sort?: string, type?: string, location?: string, store_id?: string, max_price?: number, min_price?: number, min_rating?: number }
- `POST https://api.mcp.ai/api/serpapi/yahoo/search` — Retrieve Yahoo! Search Engine Results. Supports query, location, language, and device parameters.
  - body: { b?: integer, d?: string, p: string, vc?: string, vf?: string, vl?: string, vm?: string, vs?: string, fr2?: string, device?: string, output?: string, no_cache?: boolean, yahoo_domain?: string, async_request?: boolean }
- `POST https://api.mcp.ai/api/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.
  - body: { b?: integer, p: string, durs?: string, vage?: string, vres?: string, async?: boolean, vsite?: string, device?: string, output?: string, no_cache?: boolean, zero_trace?: boolean, yahoo_domain?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { p?: integer, tab?: string, url?: string, crop?: string, site?: string, text: string, async?: boolean, color?: string, width?: integer, height?: integer, output?: string, recent?: boolean, crop_id?: string, no_cache?: boolean, file_type?: string, image_type?: string, zero_trace?: boolean, orientation?: string, yandex_domain?: string }
- `POST https://api.mcp.ai/api/serpapi/yandex/search` — Retrieve Yandex Search Results. Supports parameters like text (query), location, etc. Returns SERP data in JSON format.
  - body: { p?: integer, num?: integer, lang?: string, text: string, location?: string, yandex_domain?: string }
- `POST https://api.mcp.ai/api/serpapi/you/tube/search` — Retrieve YouTube Search Results. Supports parameters like search_query, location, etc. Returns video SERP data in JSON format.
  - body: { gl?: string, hl?: string, sp?: string, async?: boolean, output?: string, no_cache?: boolean, zero_trace?: boolean, search_query: string }

## Example prompts
- "What can I do in SerpApi?"
- "Show me a summary of my SerpApi account"

## More
- Page: https://mcp.ai/serpapi
- Agent spec (llms.txt): https://mcp.ai/serpapi/llms.txt
- Postman collection: https://mcp.ai/serpapi/postman.json