# Serply

Serply is a fast and accurate search API that provides real-time Google search results, SERP data, and web scraping capabilities. Access Google Search, Bing Search, Google Jobs, Google Scholar, Google News, and more via simple API calls.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `SERPLY`
- **Version:** 20260211_00

## Tools

### Perform Image Search

**Slug:** `SERPLY_PERFORM_IMAGE_SEARCH`

Performs an image search using the Serply API to find images matching a text query. This tool searches for images on the web and returns results with image URLs, thumbnails, dimensions, titles, and source information. Ideal for finding visual content, gathering image references, or discovering images related to specific topics or keywords. Use this when you need to: - Find images matching specific descriptions or keywords - Gather visual references for a topic - Retrieve image URLs for display or download - Search for images with specific characteristics Supports pagination, localization (language/country), and safe search filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `gl` | string | No | Two-letter country code (ISO 3166-1 alpha-2) for geographic localization of search results. For example, 'US' for United States, 'UK' for United Kingdom, 'FR' for France. |
| `hl` | string | No | Two-letter language code (ISO 639-1) for the language of search results. For example, 'en' for English, 'fr' for French, 'es' for Spanish. |
| `num` | integer | No | Number of image results to return per page. Default is 10, maximum is 100. |
| `safe` | string | No | SafeSearch filter to exclude explicit content. Use 'active' to filter adult content, or 'off' to disable filtering. Default is off when not specified. |
| `query` | string | Yes | The search query string to find images. Can be any text describing what images you want to search for. |
| `start` | integer | No | Starting index for pagination (zero-based). Use this to retrieve results beyond the first page. Default is 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Perform Maps Search

**Slug:** `SERPLY_PERFORM_MAPS_SEARCH`

Tool to perform a maps search. Use when you need to find geographic locations for a given query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `query` | string | Yes | The search query for maps (e.g., 'restaurants in Paris'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Perform Scholar Search

**Slug:** `SERPLY_PERFORM_SCHOLAR_SEARCH`

Tool to perform an academic scholar search via Serply. Use when you need scholarly literature search results for a specific query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `gl` | string | No | Country code for geotargeting, e.g., 'us'. |
| `hl` | string | No | Language code for results (ISO 639-1), e.g., 'en'. |
| `num` | integer | No | Number of results to return (max 20). |
| `query` | string | Yes | The search query string for academic literature. |
| `newWindow` | boolean | No | Whether to open result links in a new window. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |