# SerpApi AI integration on Definable

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

## What this connects

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

Vendor: https://serpapi.com/

## Tools available

**48** tools available. First 12:

- `SERPAPI_BAIDU_SEARCH` — Search Baidu with Query — 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.
- `SERPAPI_BING_MAPS` — Bing Maps Search — 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.
- `SERPAPI_BING_SEARCH` — 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.
- `SERPAPI_DUCK_DUCK_GO_LIGHT_SEARCH` — DuckDuckGo 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).
- `SERPAPI_DUCK_DUCK_GO_MAPS` — DuckDuckGo Maps search — 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.
- `SERPAPI_DUCK_DUCK_GO_SEARCH` — DuckDuckGo 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.
- `SERPAPI_EBAY_SEARCH` — 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.
- `SERPAPI_EVENT_SEARCH` — Search Google Events — 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.
- `SERPAPI_FINANCE_SEARCH` — Search finance — 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.
- `SERPAPI_GET_AVAILABLE_LOCATION_OPTIONS_FOR_GOOGLE_SEARCHES` — Get Location Options — 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.
- `SERPAPI_GET_FACEBOOK_PROFILE` — Get Facebook profile information — 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.
- `SERPAPI_GET_GOOGLE_ABOUT_THIS_RESULT` — 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use SerpApi

Inside a Definable workflow, SerpApi is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → SerpApi** — the Researcher (GPT-5.5) pulls context from SerpApi (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → SerpApi** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into SerpApi (create record, post message, draft email).
- **Designer / Engineer → Distributor → SerpApi** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via SerpApi (attach file, open PR comment, post status).

The Verifier checks every SerpApi call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- analytics — https://definable.ai/apps/category/analytics/
- ai web scraping — https://definable.ai/apps/category/ai-web-scraping/

## Related

- HTML page: https://definable.ai/apps/serpapi/
- Same category (analytics): https://definable.ai/apps/category/analytics/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt