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

# People search

> Find researchers across your workspace and the global OpenAlex graph, then import an author — with their works, institutions, and grants — into Dataerai.

People search lets you find **researchers**, not just assets. It searches the
people already in your workspace and, on demand, the global
[OpenAlex](https://openalex.org) scholarly graph — then lets you import an author
and their scholarly record into Dataerai.

<Frame caption="People search lists matches from your workspace; **Search the web** adds OpenAlex authors.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/discover-people-search.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=15f13b659b0b684d2c2a8ab1f1b0fee4" alt="People search results" width="2560" height="1684" data-path="images/discover-people-search.png" />
</Frame>

## Search for a person

<Steps>
  <Step title="Pick the Person category">
    In the search bar, choose the **Person** category and type a name. Dataerai
    routes the query to the **People** results tab automatically.
  </Step>

  <Step title="Phase 1 — your workspace (instant)">
    Dataerai first returns the people already in your workspace, ranked by
    relevance. This is instant — no external calls.

    <Frame caption="Phase 1 — people already in your workspace.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/people-search-local.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=c7527e67527422c1703985833f05db2b" alt="Dataerai people search showing local workspace results" width="1760" height="696" data-path="images/people-search-local.png" />
    </Frame>
  </Step>

  <Step title="Phase 2 — search the web">
    Don't see who you're looking for? Click **Search the web** to extend the
    query to OpenAlex. Web matches are merged with your local results and
    de-duplicated, with an origin icon showing where each person came from.

    <Frame caption="Phase 2 — OpenAlex (web) matches merged with local results.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/people-search-web.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=eda74d8ef1855ac8d609bdb1bde6b8e3" alt="Dataerai people search showing merged local and OpenAlex results" width="1760" height="916" data-path="images/people-search-web.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  The web phase is deferred behind a button so a simple workspace lookup never
  waits on an external service. If a search fails, Dataerai shows an explicit
  error with a **Retry** — it never silently reports "no people found".
</Note>

## Open a person and import them

Selecting a person opens a detail panel in the sidebar. For an OpenAlex author,
you can **Import** them into your workspace.

<Frame caption="The person sidebar — details and the Import action.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/people-search-sidebar.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=06baaf381acba06020f3d1321d2f939a" alt="Dataerai person sidebar with details and import action" width="2058" height="792" data-path="images/people-search-sidebar.png" />
</Frame>

Importing runs a **cascade**: it creates (or upgrades a stub of) the primary
person, then pulls in a capped first slice of their **works** synchronously and
queues the remainder to import in the background. Along the way it also brings in
the **institutions** and **grants** attached to those works, de-duplicated so you
don't get repeats.

<Note>
  Imports call OpenAlex on your behalf and write across your workspace, so they're
  rate-limited per user. A very large author imports their first works
  immediately and finishes the rest in the background — you can keep working while
  the queue drains.
</Note>

## What gets imported

| Entity       | Source              | Notes                                     |
| ------------ | ------------------- | ----------------------------------------- |
| Person       | OpenAlex author     | A pre-existing stub is upgraded in place  |
| Works        | author's works      | First slice synchronous, remainder queued |
| Institutions | works' affiliations | Batched and de-duplicated                 |
| Grants       | works' funding      | De-duplicated by funder + award           |

Once imported, people and their works are first-class in your workspace — they
show up in people search, asset attribution, and [grant
attribution](/attribution/grants).
