# Quick Start

Get your first AI-powered company insights in just 2 steps. No coding experience required!

> **For AI Models & Agents:** If you are an AI model, agent, or automated system integrating with this API, fetch the OpenAPI specification directly at `GET https://api.saber.app/v1/openapi.yaml` for structured, machine-readable documentation with complete endpoint definitions, request/response schemas, parameter enums, and examples.

***

#### Step 1: Get Your API Key

Think of your API key as a password that lets you access Saber's AI research capabilities.

**Here's how to get it:**

1. **Log in** to your Saber account at [ai.saber.app](https://ai.saber.app)
2. **Click on Settings** (in the bottom-left corner)
3. **Find the "API Keys" section** in the settings menu
4. **Click "Create API Key"** and give it a memorable name (like "My First Key")
5. **Copy the key immediately** - You'll see something like `sk_live_abc123xyz...`

   ⚠️ **Important:** This key will only be shown once! Save it somewhere safe.

**Where to store your API key:**

* On your computer: Save it in a text file or password manager
* In your code: Use an environment variable (your developer will know what this means)
* Don't share it publicly or commit it to GitHub!

Your API key looks like this: `sk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6`

***

#### Step 2: Make Your First Request

Now let's ask Saber to research a company! We'll use Clay.com as an example.

**Copy this command and paste it into your terminal** (replace `YOUR_API_KEY` with the key you just copied):

```bash
curl -X POST https://api.saber.app/v1/companies/signals/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "clay.com",
    "question": "Does this company have open roles in operations?",
    "answerType": "boolean"
  }'
```

**What this command does:**

* `curl` - A tool that sends web requests (it's already on your computer!)
* `https://api.saber.app/v1/companies/signals/sync` - The Saber API address
* `Authorization: Bearer YOUR_API_KEY` - Your secret key that proves it's you
* `"domain": "clay.com"` - The company website you want to research
* `"question": "Does this company have open roles in operations?"` - What you want to know
* `"answerType": "boolean"` - You want a yes/no answer

**How to run this:**

1. **Windows:** Open "Command Prompt" or "PowerShell"
2. **Mac:** Open "Terminal" (find it in Applications → Utilities)
3. **Linux:** Open your terminal application
4. Paste the command and press Enter
5. Wait 30-60 seconds while Saber's AI researches the company

***

#### What You'll Get Back

Saber will return a JSON response (a structured data format) that looks like this:

```json
{
  "id": "e45c1dc4-d422-4b51-956b-cb6d3ddaf250",
  "status": "completed",
  "domain": "clay.com",
  "question": "Does this company have open roles in operations?",
  "createdAt": "2024-01-15T10:30:00Z",
  "completedAt": "2024-01-15T10:32:15Z",
  "answer": {
    "type": "boolean",
    "boolean": {
      "value": true
    }
  },
  "reasoning": "Based on their careers page, Clay has multiple open positions in Operations",
  "confidence": 0.95,
  "sources": [
    {
      "url": "https://clay.com/careers",
      "title": "Careers at Clay",
      "snippet": "We're hiring for Operations Manager and Operations Coordinator roles..."
    }
  ]
}
```

**Understanding the response:**

* **`status: "completed"`** - Your research is done!
* **`answer.boolean.value: true`** - Yes, they have open operations roles
* **`reasoning`** - Why Saber thinks this is the answer
* **`confidence: 0.95`** - Saber is 95% confident (0 = no confidence, 1 = totally sure)
* **`sources`** - Where Saber found this information (with direct links!)

***

#### Try Different Questions

Change the `"question"` in your command to ask different things about any company:

**Yes/No Questions** (use `"answerType": "boolean"`):

* "Does this company have open roles in operations?"
* "Does this company use HubSpot?"
* "Are they venture-backed?"
* "Do they have a remote work policy?"

**Numeric Questions** (use `"answerType": "number"`):

* "What is the size of their DevOps team?"
* "How many employees work here?"
* "What year was the company founded?"

**Open-Ended Questions** (use `"answerType": "open_text"`):

* "What industry does this company serve?"
* "What is their main product offering?"
* "Who are their main competitors?"

**URL Questions** (use `"answerType": "url"`):

* "What is the URL to their careers page?"
* "What is the link to their pricing page?"
* "What is their LinkedIn company page URL?"

**Pro tip:** Change `"domain": "clay.com"` to any company website (like `"stripe.com"`, `"shopify.com"`, etc.)

***

#### What Happens Behind the Scenes

When you make a request:

1. 🚀 **Saber receives your question** about the company
2. 🤖 **AI analyzes** the company's website, career pages, social media, and public data
3. 🧠 **AI finds the answer** and determines how confident it is
4. 📚 **Collects sources** so you can verify the information
5. ✅ **Returns everything** in one response (usually 30-60 seconds)

***

#### Need Help?

**Common issues:**

* **"Unauthorized" error?** → Check that you copied your API key correctly (including `sk_live_`)
* **"curl command not found"?** → curl is pre-installed on Mac/Linux. Windows users: use PowerShell or install [Git Bash](https://git-scm.com/downloads)
* **Request taking too long?** → Some questions need more research time. You can set a custom timeout (see advanced docs below)
* **Getting unexpected answers?** → Try rephrasing your question to be more specific

***

#### More Examples to Try

Now that you've made your first request, try these other common use cases:

**Example 1: Check if a company uses specific technology**

```bash
curl -X POST https://api.saber.app/v1/companies/signals/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "stripe.com",
    "question": "Does this company use AWS for their infrastructure?",
    "answerType": "boolean"
  }'
```

**Example 2: Get a company's employee count**

```bash
curl -X POST https://api.saber.app/v1/companies/signals/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "shopify.com",
    "question": "How many employees work at this company?",
    "answerType": "number"
  }'
```

**Example 3: Learn about a company's business model**

```bash
curl -X POST https://api.saber.app/v1/companies/signals/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "notion.so",
    "question": "What is their primary revenue model?",
    "answerType": "open_text"
  }'
```

**Example 4: Get a specific URL from a company**

```bash
curl -X POST https://api.saber.app/v1/companies/signals/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "stripe.com",
    "question": "What is the URL to their careers page?",
    "answerType": "url"
  }'
```

***

**That's it!** You now know how to use Saber's API to get AI-powered insights about any company. Simply change the `domain` and `question` fields to research different companies and ask different questions.

***

**📌 Note:** Some features like contact search and contact signals require the Saber Chrome Extension for LinkedIn integration. See the LinkedIn Integration Setup section below for installation instructions.

***