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

# Quickstart

> Make your first API call in under 5 minutes

## Prerequisites

<Check>Active Yoinkit subscription</Check>
<Check>API token from Settings → OpenClaw</Check>

## Your First Request

Let's fetch the transcript of a YouTube video:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://yoinkit.ai/api/v1/openclaw/youtube/transcript?id=dQw4w9WgXcQ" \
    -H "Authorization: Bearer YOUR_API_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const YOINKIT_API_TOKEN = process.env.YOINKIT_API_TOKEN;

  const response = await fetch(
    'https://yoinkit.ai/api/v1/openclaw/youtube/transcript?id=dQw4w9WgXcQ',
    {
      headers: {
        'Authorization': `Bearer ${YOINKIT_API_TOKEN}`
      }
    }
  );

  const data = await response.json();
  console.log(data.transcript);
  ```

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

  token = os.environ.get('YOINKIT_API_TOKEN')

  response = requests.get(
      'https://yoinkit.ai/api/v1/openclaw/youtube/transcript',
      params={'id': 'dQw4w9WgXcQ'},
      headers={'Authorization': f'Bearer {token}'}
  )

  data = response.json()
  print(data['transcript'])
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "success": true,
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up",
    "duration": 213,
    "transcript": "We're no strangers to love\nYou know the rules and so do I...",
    "language": "en"
  }
}
```

## Common Workflows

### Get Video Content + Transcript

```bash theme={null}
# First, get video metadata
curl "https://yoinkit.ai/api/v1/openclaw/youtube/video?id=dQw4w9WgXcQ" \
  -H "Authorization: Bearer $YOINKIT_API_TOKEN"

# Then, get the transcript
curl "https://yoinkit.ai/api/v1/openclaw/youtube/transcript?id=dQw4w9WgXcQ" \
  -H "Authorization: Bearer $YOINKIT_API_TOKEN"
```

### Search for Trending Content

```bash theme={null}
# What's trending on YouTube in tech?
curl "https://yoinkit.ai/api/v1/openclaw/youtube/trending?category=tech" \
  -H "Authorization: Bearer $YOINKIT_API_TOKEN"

# Search TikTok for specific topics
curl "https://yoinkit.ai/api/v1/openclaw/tiktok/search?query=productivity%20tips" \
  -H "Authorization: Bearer $YOINKIT_API_TOKEN"
```

### Cross-Platform Research

```bash theme={null}
# Find content about "AI tools" across platforms
for platform in youtube tiktok twitter; do
  curl "https://yoinkit.ai/api/v1/openclaw/${platform}/search?query=AI%20tools" \
    -H "Authorization: Bearer $YOINKIT_API_TOKEN"
done
```

## Using with OpenClaw

Once you have the `yoinkit` skill installed:

```bash theme={null}
# Configure your API token
openclaw config set skills.yoinkit.env.YOINKIT_API_TOKEN "your-token"

# Now your AI assistant can research for you
```

Then just ask your assistant:

> "What's trending on YouTube in the AI space today?"

> "Pull the transcript from this TikTok video and summarize the key points"

> "Find Reddit posts about home automation that I could turn into a YouTube video"

## Next Steps

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore all available endpoints
  </Card>

  <Card title="OpenClaw Setup" icon="terminal" href="/openclaw/setup">
    Install and configure the yoinkit skill
  </Card>
</CardGroup>