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

# Google Usernames

> Check whether a person or username has accounts across popular social platforms.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

<ParamField body="query" type="string" required>
  A person name or username to check for social presence.
</ParamField>

## Response

Returns the standard Google lookup shape with only the `enrichment.usernames` section populated.

<ResponseField name="enrichment" type="object">
  <Expandable title="enrichment">
    <ResponseField name="usernames" type="object[]">Social username presence checks each with `platform`, `url`, and `exists`.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"dark"}
  {
    "query": "torvalds",
    "type": "search",
    "credits": 1,
    "enrichment": {
      "usernames": [
        { "platform": "github", "url": "https://github.com/torvalds", "exists": true },
        { "platform": "twitter", "url": "https://twitter.com/torvalds", "exists": true },
        { "platform": "instagram", "url": "https://instagram.com/torvalds", "exists": false }
      ]
    }
  }
  ```
</ResponseExample>

## Credits

1 credit per lookup.
