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

# Quickstart

> Make your first API call in under 5 minutes

## Get Started in 3 Steps

Follow this guide to make your first successful API call to SociaVault.

<Steps>
  <Step title="Get Your API Key">
    Sign up for a free account and get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard).

    <Warning>
      Keep your API key secure! Never expose it in client-side code or public repositories.
    </Warning>
  </Step>

  <Step title="Make Your First Request">
    Try fetching a TikTok profile. Replace `YOUR_API_KEY` with your actual API key:

    <CodeGroup>
      ```bash cURL theme={null}
      curl --request GET \
        --url 'https://api.sociavault.com/v1/scrape/tiktok/profile?handle=stoolpresidente' \
        --header 'X-API-Key: YOUR_API_KEY'
      ```

      ```javascript JavaScript theme={null}
      const response = await fetch(
        'https://api.sociavault.com/v1/scrape/tiktok/profile?handle=stoolpresidente',
        {
          headers: {
            'X-API-Key': 'YOUR_API_KEY'
          }
        }
      );
      const data = await response.json();
      console.log(data);
      ```

      ```python Python theme={null}
      import requests

      url = "https://api.sociavault.com/v1/scrape/tiktok/profile"
      params = {"handle": "stoolpresidente"}
      headers = {"X-API-Key": "YOUR_API_KEY"}

      response = requests.get(url, params=params, headers=headers)
      data = response.json()
      print(data)
      ```

      ```php PHP theme={null}
      <?php
      $url = 'https://api.sociavault.com/v1/scrape/tiktok/profile?handle=stoolpresidente';
      $headers = [
          'X-API-Key: YOUR_API_KEY'
      ];

      $ch = curl_init();
      curl_setopt($ch, CURLOPT_URL, $url);
      curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

      $response = curl_exec($ch);
      curl_close($ch);

      $data = json_decode($response, true);
      print_r($data);
      ?>
      ```
    </CodeGroup>

    <Tip>
      This endpoint costs **1 credit** per request. Free tier includes 100 credits.
    </Tip>
  </Step>

  <Step title="Check the Response">
    You should receive a JSON response with the TikTok profile data:

    ```json theme={null}
    {
      "user": {
        "id": "6828452746644210694",
        "uniqueId": "stoolpresidente",
        "nickname": "Dave Portnoy",
        "avatarLarger": "https://...",
        "signature": "Founder of Barstool Sports",
        "verified": true,
        "stats": {
          "followerCount": 3800000,
          "followingCount": 723,
          "heartCount": 56700000,
          "videoCount": 1245
        }
      }
    }
    ```

    <Check>
      **Success!** You've made your first API call. Now explore all 77 endpoints.
    </Check>
  </Step>
</Steps>

## What's Next?

<CardGroup cols={2}>
  <Card title="Browse All Endpoints" icon="list" href="/api-reference/introduction">
    Explore all available endpoints and platforms
  </Card>

  <Card title="Try the Playground" icon="play" href="https://sociavault.com/playground">
    Test endpoints in your browser
  </Card>

  <Card title="View Pricing" icon="credit-card" href="https://sociavault.com/pricing">
    See credit costs for each endpoint
  </Card>

  <Card title="Check Your Credits" icon="coins" href="https://sociavault.com/dashboard">
    Monitor your usage in the dashboard
  </Card>
</CardGroup>

## Common Use Cases

<AccordionGroup>
  <Accordion title="Influencer Analytics" icon="chart-line">
    Extract follower counts, engagement rates, and audience demographics across platforms to track influencer performance.

    **Endpoints**: TikTok Demographics, Instagram Profile, YouTube Channel
  </Accordion>

  <Accordion title="Content Discovery" icon="magnifying-glass">
    Search for trending content, hashtags, and viral videos to inform your content strategy.

    **Endpoints**: TikTok Trending, Instagram Reels, YouTube Search
  </Accordion>

  <Accordion title="Competitor Analysis" icon="shield-halved">
    Monitor competitor profiles, posts, and engagement to stay ahead of the competition.

    **Endpoints**: All Profile endpoints, Posts endpoints, Video endpoints
  </Accordion>

  <Accordion title="Ad Intelligence" icon="rectangle-ad">
    Track competitor ads across Facebook, Google, and LinkedIn ad libraries.

    **Endpoints**: Facebook Ad Library, Google Ad Library, LinkedIn Ad Library
  </Accordion>
</AccordionGroup>

## Need Help?

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@sociavault.com">
    Get help from our support team
  </Card>

  <Card title="Join Discord" icon="discord" href="https://discord.gg/sociavault">
    Chat with our community
  </Card>
</CardGroup>