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

# Introduction

> The Company Social Graph API

companies.social is an API that resolves any company identifier — a domain, Twitter handle, LinkedIn URL, or GitHub org — and returns every linked social profile for that company.

## How it works

Pass any identifier you have, get back the full social graph:

```bash theme={null}
curl -H "x-api-key: ck_your_key" \
  https://api.companies.social/domain/stripe.com
```

```json theme={null}
{
  "companyId": "stripe_com",
  "domain": "stripe.com",
  "socials": {
    "twitter": "https://x.com/stripe",
    "linkedin": "https://linkedin.com/company/stripe",
    "github": "https://github.com/stripe",
    "youtube": "https://youtube.com/@stripe",
    "instagram": "https://instagram.com/stripe",
    "facebook": "https://facebook.com/StripeHQ"
  },
  "scrapedAt": "2026-03-01T12:00:00.000Z",
  "cached": true
}
```

## Supported platforms

| Platform  | Lookup by domain | Reverse lookup |
| --------- | :--------------: | :------------: |
| Twitter   |      Active      |     Passive    |
| LinkedIn  |      Active      |     Active     |
| GitHub    |      Active      |     Active     |
| YouTube   |      Active      |     Active     |
| TikTok    |      Active      |     Active     |
| Instagram |      Active      |     Passive    |
| Facebook  |      Active      |     Passive    |

**Active** lookups fetch and parse in real-time. **Passive** lookups resolve from data built by prior domain scrapes. **Reverse lookup** means you can query by that platform's handle to find the company's full social graph.

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Make your first API call in 30 seconds
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Set up your API key
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore every endpoint
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/rate-limits">
    Understand usage limits by plan
  </Card>
</CardGroup>
