# 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. *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.saber.app/quick-start.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.