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

# Social

> Social brings together interaction commands and manual lookups of public Instagram and Roblox profiles. Instagram metrics require Meta's official integration; the page does not publish activity alerts.

## Community interactions

Headless registers `slap`, `punch`, `kiss`, `pet`, `hug`, `kill`, `marry`, `marriage`, `divorce`, and `ship`. These are in-Discord social responses, not moderation sanctions. Most run in servers and use per-user cooldowns; mentions and GIFs depend on the command and available resources.

Social-generated copy and control labels are displayed in English. Member- and provider-authored names, notes, and biographies are not translated.

> **Complete command reference**
>
> * **`.slap <member> [note]`** — **Use and behavior:** A social slap; you can also reply to the member's message instead of mentioning them. · **Access and cooldown:** Server; 4 s per user
> * **`.punch <member> [note]`** — **Use and behavior:** A punch interaction; a target is required. · **Access and cooldown:** Server; 4 s per user
> * **`.kiss <member> [note]`** — **Use and behavior:** A kiss interaction; a target is required. · **Access and cooldown:** Server; 4 s per user
> * **`.pet <member> [note]`** — **Use and behavior:** A pet interaction; a target is required. · **Access and cooldown:** Server; 4 s per user
> * **`.hug [member] [note]`** — **Use and behavior:** A directed hug; with no target or replied-to message, it applies to the invoking user. · **Access and cooldown:** Server; 4 s per user
> * **`.kill <member> [note]`** — **Use and behavior:** A fictional KO action; a target is required and bots cannot be targeted. · **Access and cooldown:** Server; 4 s per user
> * **`.marry [member] [note]`** — **Use and behavior:** Without a member, checks your status; with one, sends a proposal that the other person must accept. It cannot register a marriage with bots or people already paired. · **Access and cooldown:** Server; 12 s per user
> * **`.marriage [member]`** — **Use and behavior:** Checks your own or another member's marriage status. · **Access and cooldown:** Server; 5 s per user
> * **`.divorce [reason]`** — **Use and behavior:** Removes the relationship record for both people; the reason is optional. · **Access and cooldown:** Server; 12 s per user
> * **`.ship <member_a> [member_b]`** — **Use and behavior:** With one member, scores the invoking user and that person; with two, scores the selected pair. The score is stable for the same pair in the same server. · **Access and cooldown:** Server; 6 s per user
> * **`.instagram <username>` (`.ig`, `.insta`)** — **Use and behavior:** Looks up a public profile; if Meta is not configured, it only provides a profile link. · **Access and cooldown:** Prefix or `/buscar instagram` and `/buscar ig`; 3 s per user

Social interactions require no moderation permissions. Instagram also requires no elevated permissions and can be used outside a server; Roblox is documented separately in [Roblox Avatar](/docs/en/integrations/roblox-avatar.md).

> **Usage**
>
> Mention another person or reply to their message. Social cards use available GIFs with a fallback image when a source fails; each command keeps its own cooldown.

> **Marry**
>
> The proposal shows buttons to accept or reject. Check status with `marry` or `marriage`; `divorce` removes both relationship records saved for that server.

> [!NOTE]
>
> Social interactions run through commands. The current configuration does not expose a Social module in the Dashboard or per-response auto-delete controls. There is no registered `pat` command; use the commands listed above.

### `.hug`

```headless-command Syntax theme={null}
.hug [target] [note]
```

```headless-command Example theme={null}
.hug @Member
```

### `.ship`

```headless-command Syntax theme={null}
.ship [member_a] [member_b]
```

```headless-command Example theme={null}
.ship @Member @Other
```

## Public Instagram lookups

Use `.instagram`, `.ig`, or `.insta`, or `/buscar instagram` and `/buscar ig`. The input can be a username, `@username`, or an `instagram.com` link. Metrics use Meta's official Business Discovery API and require Headless to be configured with a token and Instagram professional-account ID. Without that setup, the command offers the safe profile link and explains that metrics are unavailable. It does not log in as the member or read private accounts.

### `.instagram`

```headless-command Syntax theme={null}
.instagram <username>
```

```headless-command Example theme={null}
.instagram @username
```

### `/buscar ig`

```headless-command Syntax theme={null}
/buscar ig username:<username>
```

```headless-command Example theme={null}
/buscar ig username:@username
```

## Roblox: profile search

Use `.roblox`, `.rbx`, or `.rblx`, or `/buscar roblox` and `/buscar rbx`. Queries can be a username, display name, ID, or profile URL. The response may include an avatar, display name, creation date, account state, verification badge, friend/follower counts, groups, and available public presence. It is a read-only lookup against Roblox APIs; it does not link an account or request credentials.

### `.roblox`

```headless-command Syntax theme={null}
.roblox <query>
```

```headless-command Example theme={null}
.roblox builderman
```

### `/buscar roblox`

```headless-command Syntax theme={null}
/buscar roblox query:<query>
```

```headless-command Example theme={null}
/buscar roblox
```

> [!WARNING]
>
> Do not treat private profiles as accessible or request anyone's password. Do not use these commands to harass members or amplify information out of context.

**Note:**

Instagram and Roblox show public data made available by their providers. Instagram uses Business Discovery; without official credentials, the command only provides a profile link. Roblox may omit presence or count fields if its API does not return them.

## Integrations and limits

TikTok and Pinterest use separate OAuth flows to connect an account you own through the Dashboard; that authorization does not turn this page into a notification service. Instagram/Roblox results depend on provider setup and availability. Commands rate-limit each user and return recoverable feedback when a provider rejects or limits a request.

## Steps

**1. Choose a lookup or interaction**

Use a social command for a one-off response, or Instagram/Roblox to look up a public profile.

**2. Check the input**

Instagram accepts a username, `@username`, or official profile URL. Roblox accepts a username, display name, ID, or profile URL.

**3. Open the profile and respect its limits**

Review the result card and open its profile link. Do not bypass provider restrictions or use the commands to harass someone.

> **Lookup cooldowns**
>
> Instagram limits each user to one lookup every 3 seconds. Roblox limits each user to one lookup every 4 seconds. Social interactions also use per-user cooldowns, with a separate interval for `marry`; if Discord reports a cooldown, wait before trying again.

## Related pages

* [TikTok](/docs/en/integrations/tiktok.md)
* [Pinterest](/docs/en/integrations/pinterest.md)
* [Roblox Avatar](/docs/en/integrations/roblox-avatar.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.