# Extract emails and URLs

Pull every email address and web link out of a text, and optionally IPv4 addresses and hashtags.

- Endpoint: `POST https://setget.net/v1/tools/extract-emails-urls` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `extract-emails-urls`
- Page: https://setget.net/tools/extract-emails-urls

## Inputs

- `text` (required, string): The text to search.
- `include_ips` (optional, boolean, default `false`): Also list IPv4 addresses.
- `include_hashtags` (optional, boolean, default `false`): Also list hashtags such as #news.

## Example 1

```json
{"input":{"text":"Mail sam@example.com or alex@example.org, see https://example.com/docs."}}
```

Result:

```json
{"emails":["sam@example.com","alex@example.org"],"urls":["https://example.com/docs"],"count":3}
```

## Example 2: With IP addresses and hashtags

```json
{"input":{"text":"Server 10.0.0.5 is down (www.example.com/status) #outage #outage","include_ips":true,"include_hashtags":true}}
```

Result:

```json
{"emails":[],"urls":["www.example.com/status"],"ips":["10.0.0.5"],"hashtags":["#outage"],"count":3}
```

**Which links are found?** Links that start with http://, https://, ftp:// or www. A bare domain such as "example.com" is not listed.

**Are duplicates removed?** Yes. Each value is listed once, in the order it first appears.

**Does it check that an address really exists?** No. It only looks at the shape of the text and never contacts the network.
