> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Web search and pages

> Search the web and the news, and pull contacts, sitemaps, and SEO tags from a site. Look up domain and email details, plus Google's autocomplete and trends.

Search the web and the news, and pull contacts, sitemaps, and SEO tags from a site. Look up domain and email details, plus Google's autocomplete and trends. See every field in the [Web search and pages reference](/api-reference/endpoint/web-search), or try it in the [playground](https://stophy.dev/playground).

## Search the web and get titles, links and snippets

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.web.search({ query: "best project management software", limit: 10 });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.web.search(query="best project management software", limit=10)
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/web/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"query":"best project management software","limit":10}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy web search "best project management software" --limit 10
  ```
</CodeGroup>

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "results": [
      {
        "title": "Top 10 Project Management Software I Tested & Recommend for 2026",
        "url": "https://project-management.com/top-10-project-management-software/",
        "description": "2 weeks ago - The best project management software is monday.com for visual planning and beginners, ClickUp for task hierarchies, Jira for agile software delivery, Asana for workflow automation, and Teamwork for professional services.",
        "domain": "project-management.com",
        "position": 1
      },
      {
        "title": "10 Best Project Management Software Picked For 2026",
        "url": "https://thedigitalprojectmanager.com/tools/best-project-management-software/",
        "description": "4 days ago - Project management software earns its place when it gives teams real visibility, handles resource planning, and scales with your workload. I evaluated 40 options.",
        "domain": "thedigitalprojectmanager.com",
        "position": 2
      }
    ]
  },
  "creditsUsed": 0,
  "requestId": "08a1799a-c64c-4d69-a39f-34fe91139d31"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Search the web and get titles, links and snippets](/api-reference/endpoint/web-search) | 1 credit per 10 items, at least 1 credit (no key needed) |
| [Search news articles by topic, date and country](/api-reference/endpoint/web-news) | 2 credits per 10 items, at least 2 credits |
| [Find emails, phone numbers and social profiles on a website](/api-reference/endpoint/web-contacts) | 2 credits per 5 items, at least 2 credits |
| [List every page on a website](/api-reference/endpoint/site-map) | 2 credits per 500 items, at least 2 credits |
| [Check a page's SEO: titles, tags, headings and links](/api-reference/endpoint/site-seo) | 2 credits per 2 items, at least 2 credits |
| [Get a domain's registrar and key dates](/api-reference/endpoint/domain-whois) | 1 credit |
| [Get a domain's DNS records](/api-reference/endpoint/domain-dns) | 1 credit |
| [Find the technologies a website uses](/api-reference/endpoint/domain-tech) | 1 credit |
| [Check if email addresses can receive mail](/api-reference/endpoint/email-check) | 1 credit per 10 items, at least 1 credit |
| [Get Google search suggestions for a keyword](/api-reference/endpoint/google-suggest) | 1 credit per 50 items, at least 1 credit |
| [Get search interest over time](/api-reference/endpoint/google-trends-interest) | 1 credit |
| [Get search interest by region](/api-reference/endpoint/google-trends-regions) | 1 credit |
| [Get related searches for a keyword](/api-reference/endpoint/google-trends-related) | 1 credit |
| [Get what is trending on Google now](/api-reference/endpoint/google-trends-trending) | 1 credit per 50 items, at least 1 credit |

## More ways to call it

### List every page on a website

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.site.map({ url: "https://stripe.com", limit: 500 });
  console.log(result.data.urls);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.site.map(url="https://stripe.com", limit=500)
  print(result["data"]["urls"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/site/map \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"url":"https://stripe.com","limit":500}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy site map https://stripe.com --limit 500
  ```
</CodeGroup>

### Get a domain's registrar and key dates

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.domain.whois({ domain: "stripe.com" });
  console.log(result.data.domain);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.domain.whois(domain="stripe.com")
  print(result["data"]["domain"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/domain/whois \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"domain":"stripe.com"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy domain whois stripe.com
  ```
</CodeGroup>

<Tip>Send `accept: text/markdown` to any of these endpoints to get a readable page instead of JSON. See [Get markdown for a model](/guides/markdown).</Tip>