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

# First query

> Run a focused company search and understand the response.

This walkthrough uses a company search because it needs only a few filters and
produces an easy-to-check result.

## Prerequisite

Complete [Installation](/installation) and confirm that your client can see the
Superdata tools.

<Steps>
  <Step title="Ask a focused question">
    Send this request in your connected client:

    ```text theme={null}
    Use Superdata to find fintech companies in the United Kingdom with
    20–200 employees. Return up to 10 results.
    ```
  </Step>

  <Step title="Confirm the selected tool">
    Your client should call `superdata_search_companies` with industry,
    country, employee-range, and limit filters. Superdata validates those
    filters before execution.
  </Step>

  <Step title="Review the result">
    A completed response contains `status`, `count`, `companies`, `hasMore`,
    and `nextCursor`. Company records can include name, website, industry,
    location, and employee count.
  </Step>

  <Step title="Continue when needed">
    If `hasMore` is `true`, ask the client for the next page. It must send the
    returned `nextCursor` without changing the original filters.
  </Step>

  <Step title="Check usage">
    Open **Dashboard → Usage overview** in Superdata. The recent activity table
    shows the tool, outcome, duration, timestamp, and credit charge.
  </Step>
</Steps>

## Try a people search

Once the first search works, ask:

```text theme={null}
Use Superdata to find VP Sales and Head of Sales profiles in the United States
who currently work at SaaS companies with 50–500 employees. Return 10 results.
```

People searches work best when you provide role, country, company industry, and
company size. Missing context can produce a clarification response before
execution; clarification does not consume a credit.

<Note>
  Work email, phone, website, location, and employee-count fields can be `null`
  when no verified provider value is available. Superdata does not invent
  missing contact data.
</Note>

Next, explore more [Usage patterns](/guides/usage-patterns) or review the full
[Tool catalog](/reference/tools).