> ## 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.

# Usage patterns

> Practical ways to use Superdata for company research, people discovery, and prospecting.

Superdata produces the most useful results when a request states who you want,
where they are, and what makes them relevant.

## Build a target-account list

Combine industry, country, and employee range to create a focused company set.

```text theme={null}
Find cybersecurity companies in Germany with 50–500 employees.
```

Use this pattern for territory planning, market mapping, and account research.

## Find decision-makers

Add current roles and current-company characteristics to a people search.

```text theme={null}
Find Heads of Engineering and VPs of Engineering in Canada who work at fintech
companies with 100–1,000 employees.
```

Include role, country, industry, and size whenever possible. If a required
dimension is missing, answer the clarification instead of asking the client to
guess.

## Enrich a prospecting workflow

Use the company tool to identify accounts, then run a people search using the
same market and company-size context. Review provider-supplied work email and
phone fields before using them downstream.

<Warning>
  MCP results remain in the conversation that requested them. They appear as
  metered calls in Usage but are not currently copied into a saved dashboard
  workspace or lead list automatically.
</Warning>

## Explore a broader market

Start with a page of up to 50 records. When `hasMore` is `true`, continue with
the opaque `nextCursor` and the exact same filters. Narrow the request if it
times out or returns too much irrelevant coverage.

## Refine a no-match search

Change one constraint at a time:

1. Confirm the country and industry terms.
2. Widen the company employee range.
3. Reduce the number of required job titles.
4. Retry without a cursor.

A completed no-match execution costs one credit. Clarification and invalid-input
responses occur before execution and cost zero credits.

## Prompt checklist

Before sending a request, check that it includes:

* The result type: companies or people
* Current industries or company industries
* Countries or current locations
* Minimum and maximum employee count
* Current job titles for people searches
* A result limit between 1 and 50

See the [Tool catalog](/reference/tools) for exact fields and
[Understanding results](/guides/understanding-results) for response behavior.