> For the complete documentation index, see [llms.txt](https://coldscrape.gitbook.io/coldscrape-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coldscrape.gitbook.io/coldscrape-knowledge-base/lead-generation/searches.md).

# Searches

## Search

A new "search" is when you enter in a business type and a location. (ex. Plumbers in San Jose, CA) 

Starting a new "search" involves entering in a business category and location, for example "Plumbers in San Jose, CA." This process ensures that the final search results are relevant businesses within your defined parameters.

**👉 NOTE: There may be multiple contact emails in a single search result.** In cases where multiple emails are discovered, we provide **all identified emails at no additional cost.** 

## Keyword

This is the main keyword you are using to search for businesses. For example if you are looking for plumbers then you would search for the keyword 'plumber'. 

[Google has over 4,000 different unique business categories](https://daltonluka.com/blog/google-my-business-categories) in Google which is a good place to find ideas of what ot search.

<figure><img src="/files/BLq0oIPWqr80G8UdKY0d" alt=""><figcaption></figcaption></figure>

## Maximum Search Results (Businesses)

Enter in a number of search results (businesses) you want this particular search to look for. After the system finds the number of businesses it will stop searching.&#x20;

This is to ensure that your account will only search for the number of search results you enter.&#x20;

## Location (City or State)

This is a location selector. So you start typing the area where you want to search and it will show you the locations that the system has a match for.&#x20;

In the graphic below you can see how there are two different searches for different areas which yielded multiple results.&#x20;

<figure><img src="/files/OFvrlLM3f4PXPxQsyncb" alt=""><figcaption><p>How ColdScrape Works</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://coldscrape.gitbook.io/coldscrape-knowledge-base/lead-generation/searches.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.