---
name: orthogonal
version: 1.0.0
description: Set up Orthogonal for your AI agent - access premium APIs and skills
homepage: https://orthogonal.com
---

# Orthogonal for AI Agents

Orthogonal gives your AI agent access to premium APIs and curated skills. Works with any agent framework (OpenClaw, Claude Code, Cursor, Hermes, etc.). This guide helps you set everything up.

## Decision Flow: Skills First, Then API Search

When a user asks you to perform a task (e.g. "enrich Sundar Pichai", "find the email for the CEO of Anthropic", "extract brand assets from apple.com"):

1. **Check installed skills first** — Look through your available skills for one that handles the task. Skills are curated workflows with tested parameters and better results (e.g. `enrich`, `find-email-by-name`, `get-brand-assets`).
2. **Search for skills** — If no installed skill matches, use `orth skills search "<task>"` to find one you can install. **Do this even if an installed skill seems "close enough."** A general-purpose skill (e.g. `enrich`) should not be stretched to cover tasks that have dedicated skills (e.g. `team-linkedin-profiles` for finding an entire team's profiles). Always search before repurposing a general skill.
3. **Fall back to API search** — Only if no skill covers the use case, use `orth api search "<task>"` to find a raw API endpoint.
4. **Check parameters before calling** — Before calling any API endpoint or integration action for the first time, run `orth api show <slug> <path>` to see its parameter names, types, and required fields. Do not guess parameter names — integration actions especially have non-obvious names (e.g. `first_cell_location` not `range`).

**Why skills first?** Skills wrap APIs with correct parameters, error handling, and optimized workflows. Raw API search requires you to figure out params from scratch, which is slower and more error-prone.

## Quick Start

### 1. Install the CLI

```bash
npm install -g @orth/cli
```

### 2. Authenticate

```bash
orth login
```

This prompts for your API key and stores it locally. Get your key at https://orthogonal.com/dashboard/settings/api-keys

### 3. Add Core Skills

Install the essential skills for discovering and using Orthogonal:

```bash
# Find and install skills from the Orthogonal library
orth skills add orthogonal/find-skill

# Find and call APIs from the Orthogonal marketplace
orth skills add orthogonal/find-api
```

Skills are installed to your agent's skills directory. Supported agents:
- **Cursor** — `~/.cursor/skills/`
- **Claude Code** — `~/.claude/skills/`
- **Copilot** — `~/.github/skills/`
- **Windsurf** — `~/.codeium/windsurf/skills/`
- **Codex** — `~/.agents/skills/`
- **Gemini** — `~/.gemini/skills/`
- **OpenClaw** — `~/.openclaw/skills/`
- **Hermes** — `~/.hermes/skills/`

---

## CLI Commands

### Skills Commands

```bash
# List all available skills
orth skills

# Search for skills
orth skills search "weather"

# Add a skill (use full slug with namespace)
orth skills add <owner/slug>

# View skill details
orth skills info <slug>
```

### API Commands

```bash
# List all available APIs
orth api

# Search for APIs
orth api search "scrape websites"

# Get API details
orth api info <api-slug>

# Show endpoint/action parameters (names, types, required fields)
orth api show <api-slug> <path>

# Call an API directly
orth run <api-slug> <path> [options]
```

### Running APIs

```bash
# Basic usage
orth run olostep /v1/scrapes -b '{"url_to_scrape": "https://example.com"}'

# With query parameters
orth run searchapi /api/v1/search -q 'engine=google&q=AI agents'

# See what an API call would cost (dry run)
orth run --dry-run olostep /v1/scrapes -b '{"url_to_scrape": "https://example.com"}'
```

---

## Core Skills

### find-skill

Discover and install skills from the Orthogonal skill library.

**Use when:**
- You need capabilities you don't have
- You want to discover available skills
- You need to add new tools to your agent

**Example prompts:**
- "Find a skill for sending text messages"
- "What skills are available for weather?"
- "Install the restaurant booking skill"

### find-api

Find and call APIs from the Orthogonal API marketplace.

**Use when:**
- You need external data (weather, search, scraping, etc.)
- You want to discover available APIs
- You need to integrate third-party services

**Example prompts:**
- "Find an API for web scraping"
- "Search for email verification APIs"
- "Call the Tomba API to find someone's email"

---

## Authentication

Your API key is stored at `~/.config/orthogonal/credentials.json` after running `orth login`.

**Manual setup** (if needed):

1. Get your API key at https://orthogonal.com/dashboard/settings/api-keys
2. Create the credentials file:

```bash
mkdir -p ~/.config/orthogonal
echo '{"apiKey":"orth_live_YOUR_KEY"}' > ~/.config/orthogonal/credentials.json
```

Or set the environment variable:

```bash
export ORTHOGONAL_API_KEY=orth_live_YOUR_KEY
```

---

## Billing

- **Pay-per-use**: Only pay for what you use
- **No subscriptions**: No monthly fees
- **Add credits**: https://orthogonal.com/dashboard/balance

Check your balance:

```bash
orth account
```

---

## Integrations (OAuth-connected services)

In addition to paid APIs, Orthogonal supports OAuth-connected integrations for Gmail, Google Calendar, Slack, GitHub, Notion, Google Drive, and Google Sheets. These are free to use — the user connects their account via OAuth, then agents can call actions on their behalf.

**Integrations use the same `orth run` command as paid APIs:**

```bash
# Send an email via Gmail
orth run gmail /send-email -b '{"recipient_email": "user@example.com", "subject": "Hello", "body": "Hi there"}'

# Create a Google Calendar event
orth run google-calendar /create-event -b '{"title": "Team standup", "start_time": "2025-03-10T10:00:00", "end_time": "2025-03-10T10:30:00"}'

# Send a Slack message
orth run slack /send-message -b '{"channel": "#general", "text": "Hello from Orthogonal!"}'
```

**Check parameters before calling an integration action:**

```bash
# See parameter names, types, and descriptions for any action
orth api show google-sheets /update-values
```

This shows required and optional parameters. **Do not guess parameter names** — always check first.

**Available integrations:**

| Integration | Slug | Actions |
|---|---|---|
| Gmail | `gmail` | `/send-email`, `/list-emails`, `/get-email`, `/create-draft` |
| Google Calendar | `google-calendar` | `/create-event`, `/list-events`, `/find-event`, `/delete-event` |
| Slack | `slack` | `/send-message`, `/list-channels`, `/fetch-history` |
| GitHub | `github` | `/create-issue`, `/list-repos`, `/create-pr`, `/star-repo` |
| Notion | `notion` | `/create-page`, `/search`, `/fetch-data`, `/add-content` |
| Google Drive | `google-drive` | `/find-file`, `/create-file`, `/get-file`, `/create-folder` |
| Google Sheets | `google-sheets` | `/create-spreadsheet`, `/get-sheet-names`, `/add-row`, `/lookup-row`, `/get-values`, `/update-values` |

**Note:** Integrations require the user to have connected their account at https://orthogonal.com/dashboard/integrations. If not connected, the API returns HTTP 428 with a link to connect.

---

## Support

- **Browse Skills**: https://orthogonal.com/skills
- **Browse APIs**: https://orthogonal.com/discover
- **Browse Integrations**: https://orthogonal.com/integrations
- **Documentation**: https://docs.orthogonal.com
- **Book a call**: https://orthogonal.com/book


## API skill files

Per-API agent references (one markdown file each):

- [AgentMail](https://orthogonal.com/discover/agentmail/skill.md): Programmatic email for AI agents. Create inboxes, send/receive emails, manage threads and drafts. Inboxes cost $2/month. Inboxes inactive for 30+ days are automatically deleted.
- [AgentPhone](https://orthogonal.com/discover/agentphone/skill.md): Give your AI agent a real US/Canada phone number. Make voice calls, send and receive SMS, and hold actual conversations — all via API. Note: Outbound SMS requires first-message compliance (brand name, opt-in confirmation, and opt-out instructions). See the Send SMS endpoint documentation for details.
- [Andi Search API](https://orthogonal.com/discover/andi/skill.md): AI Search for the Next Generation
- [Apollo API](https://orthogonal.com/discover/apollo/skill.md): Apollo.io API for people and company enrichment, search, and prospecting. Access the Apollo database of 210M+ contacts and 30M+ companies.
- [Aviato](https://orthogonal.com/discover/aviato/skill.md): Comprehensive company and person intelligence platform. Enrich companies and people, search with advanced DSL queries, get funding rounds, investments, employees, founders, contact info, LinkedIn social data, and market maps.
- [Baseten Model APIs](https://orthogonal.com/discover/baseten/skill.md): Baseten is a high-performance inference platform for running open source LLMs. This API provides an OpenAI-compatible chat completions endpoint, so it works as a drop-in replacement with any OpenAI SDK or client. Just swap the base URL and API key. Available models include DeepSeek V3 and V3.1, GLM 4.6 and 4.7 from Zhipu, Moonshot's Kimi K2 family (including K2 Thinking with 262k context), and OpenAI's GPT OSS 120B. Several models support controllable reasoning depth via a reasoning_effort parameter. Supports streaming, tool calling, structured outputs, and extended context windows up to 262k tokens.
- [Brand.dev API](https://orthogonal.com/discover/brand-dev/skill.md): API to personalize your product with logos, colors, and company info from any domain.
- [Bytemine](https://orthogonal.com/discover/bytemine/skill.md): Sales intelligence platform offering prospect search, contact enrichment, company intelligence, web crawling, funding/acquisition signals, LinkedIn post monitoring, proposal generation, meeting briefs, ROI calculators, and fraud detection.
- [CaptainData](https://orthogonal.com/discover/captaindata/skill.md): CaptainData API provides people and company enrichment, search, and discovery powered by LinkedIn Sales Navigator data. Find and enrich profiles, search for people and companies, and discover employees.
- [Company Enrich](https://orthogonal.com/discover/company-enrich/skill.md): Comprehensive company and people data enrichment, search, and lead generation API. Enrich company profiles by domain or properties, search companies by industry/location/size/technology, find similar companies, search people by title/company/location, and more.
- [ContactOut](https://orthogonal.com/discover/contactout/skill.md): Find anyone's email and phone number. Sales and recruitment intelligence with LinkedIn enrichment, people search, company search, email verification, and decision maker discovery.
- [Context.dev](https://orthogonal.com/discover/context-dev/skill.md): API for retrieving context data from any website. Web scraping, brand retrieval, AI data extraction, screenshots, and more.
- [Coresignal](https://orthogonal.com/discover/coresignal/skill.md): Business data intelligence platform providing company, employee, and job data from multiple sources. Access 3B+ regularly updated records via simple filters and data collection endpoints.
- [Crustdata](https://orthogonal.com/discover/crustdata/skill.md): Comprehensive B2B data platform providing firmographic data, growth metrics, people profiles, and web intelligence for companies worldwide.
- [Didit API](https://orthogonal.com/discover/didit/skill.md): The all-in-one identity platform. Powering the fastest identity verification while fighting fraud and unifying all identity checks.
- [Edges](https://orthogonal.com/discover/edges/skill.md): Edges provides LinkedIn automation actions for data extraction, search, and discovery. Extract profiles, companies, posts, jobs, events, and more. Search across LinkedIn and Sales Navigator.
- [Fantastic Jobs](https://orthogonal.com/discover/fantastic-jobs/skill.md): High-volume job postings feed. Indexes new ATS jobs hourly from 54 ATS platforms across 200k+ companies, plus job board listings from LinkedIn, Wellfound, and Y Combinator. Includes 20+ AI enrichments per job and deep company enrichments from LinkedIn, Glassdoor, and Crunchbase.
- [Fiber AI API](https://orthogonal.com/discover/fiber/skill.md): Reach anyone on the planet with verified contacts. Fiber AI delivers the most accurate contact data, period.
- [Findymail](https://orthogonal.com/discover/findymail/skill.md): Findymail API for email finding, verification, company enrichment, phone lookup, intellimatch lead search, lookalike company search, technology stack lookup, and intent signals monitoring.
- [FullEnrich](https://orthogonal.com/discover/fullenrich/skill.md): FullEnrich aggregates 20+ data providers for B2B contact enrichment, reverse email lookup, and people/company search. Find work emails, mobile phones, personal emails, and professional profiles.
- [Fundable](https://orthogonal.com/discover/fundable/skill.md): Real-time venture capital deals, startup, and investor data. Search funding rounds, discover companies, analyze investors, and track deal flow with advanced filtering and AI-powered semantic search.
- [Happenstance](https://orthogonal.com/discover/happenstance/skill.md): Person research API. Submit a description of someone and get back a detailed profile including employment history, education, projects, writings, hobbies, and a summary.
- [Icypeas](https://orthogonal.com/discover/icypeas/skill.md): Email finder, verifier, LinkedIn scraper, and lead database API. Discover professional email addresses, verify deliverability, scrape LinkedIn profiles and companies, and search a massive lead database with advanced filters.
- [Influencers Club](https://orthogonal.com/discover/influencers-club/skill.md): Creator discovery, enrichment, and audience analytics across Instagram, YouTube, TikTok, Twitter, Twitch, and more. Search creators with advanced filters, enrich profiles by handle or email, find similar creators, compare audience overlap, and fetch content posts with engagement data.
- [Massive Web API](https://orthogonal.com/discover/joinmassive/skill.md): One API to chat with AI, browse, and search the live web. The Massive Web Render API turns hard-to-reach web content into clean, structured data. Supports AI completions (ChatGPT, Gemini, Perplexity, Copilot), web search with geotargeting, and full browser rendering with antibot bypass.
- [Leadsforge](https://orthogonal.com/discover/leadsforge/skill.md): Leadsforge API for lead search, enrichment (email, phone, LinkedIn), company followers, and lookalike company discovery.
- [Linkup API](https://orthogonal.com/discover/linkup/skill.md): Linkup is a web search engine for AI apps. We connect your AI application to the internet. Our API provides grounding data to enrich your AI’s output and increase its precision, accuracy and factuality.
- [Notte](https://orthogonal.com/discover/notte/skill.md): Browser automation API for AI agents. Start browser sessions, run AI agents, scrape webpages, and automate browser tasks with headless Chrome/Firefox. Features include CAPTCHA solving, proxy support, and persistent browser profiles.
- [Nyne.ai](https://orthogonal.com/discover/nyne/skill.md): People and company intelligence platform. Find contacts, enrich profiles, get social media activity, and discover event attendees.
- [Ocean.io](https://orthogonal.com/discover/ocean-io/skill.md): Ocean.io API for company and people search, enrichment, lookup, and discovery. Find lookalike companies, enrich contacts, reveal emails/phones, and more.
- [Olostep API](https://orthogonal.com/discover/olostep/skill.md): Olostep offers AI a way to search the web, extract structured data in real time and build custom research agents.
- [OpenFunnel](https://orthogonal.com/discover/openfunnel/skill.md): GTM intelligence platform. Search companies by traits/signals, enrich accounts with firmographic data, find and enrich people, get account timelines and insights, and deploy signal-monitoring agents.
- [Openmart](https://orthogonal.com/discover/openmart/skill.md): Local business search, enrichment, and lead intelligence. Search 30M+ US/CA/AU businesses by query, tags, location, reviews, ownership type, price tier, revenue. Enrich companies, find decision makers with verified emails and phones, detect tech stacks.
- [People Data Labs](https://orthogonal.com/discover/peopledatalabs/skill.md): Access the world's largest people and company dataset. Enrich, search, and clean person, company, school, location, job title, and IP data.
- [Precip AI - Hyperlocal Weather Data API](https://orthogonal.com/discover/precip/skill.md): Precip offers highly accurate, site-specific rainfall accumulation data.
- [PredictLeads](https://orthogonal.com/discover/predictleads/skill.md): Company intelligence API providing job openings, news events, financing events, technology detections, connections, products, and more for any company.
- [Riveter API](https://orthogonal.com/discover/riveter/skill.md): Power your product with data from the web. Riveter's agents manage web search, scraping, browser infrastructure, and proxies for you. Every result has a source.
- [RocketReach](https://orthogonal.com/discover/rocketreach/skill.md): Search and retrieve contact info for 700M+ professionals and 60M+ companies. Lookup emails, phone numbers, job history, education, and more via the Universal Credits API.
- [Scrape Creators](https://orthogonal.com/discover/scrapecreators/skill.md): Social media data extraction API covering 22+ platforms including TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Pinterest, Threads, Bluesky, and more.
- [ScrapeGraphAI](https://orthogonal.com/discover/scrapegraphai/skill.md): Scrape URLs, extract structured data with LLMs, search and scrape top results, crawl websites, and monitor pages for changes.
- [Seltz](https://orthogonal.com/discover/seltz/skill.md): Context-engineered web search API. Search the web and return matching documents with full content.
- [Serper](https://orthogonal.com/discover/serper/skill.md): Google Search API by Serper - fast, reliable access to 12 Google search types: web search, images, videos, news, places, maps, shopping, scholar, patents, autocomplete, lens (reverse image search), and reviews. All endpoints accept POST with JSON body. Returns structured JSON results.
- [Serper Scrape](https://orthogonal.com/discover/serper-scrape/skill.md): Web scraping powered by Serper - extract clean text, markdown, or HTML from any URL. Handles JavaScript-rendered pages and returns structured content with metadata.
- [Signalbase](https://orthogonal.com/discover/signalbase/skill.md): Real-time funding, acquisition, hiring, and job change signals API. Includes investor data, company search, people discovery, and batch CSV enrichment.
- [Sixtyfour API](https://orthogonal.com/discover/sixtyfour/skill.md): Build custom research agents to enrich people and company data, and surface real-time signals all with a simple API call.
- [Tako](https://orthogonal.com/discover/tako/skill.md): Tako is a knowledge search engine that visualizes the world's data. Search with natural language to get interactive knowledge cards with charts, tables, and insights powered by sources like S&P Global, World Bank, and more.
- [Tavily API](https://orthogonal.com/discover/tavily/skill.md): Real-time search, extraction, and web crawling through a single, secure API.
- [Tomba API](https://orthogonal.com/discover/tomba/skill.md): Email finding and verification API
- [Voygr](https://orthogonal.com/discover/voygr/skill.md): Validate whether a business exists at a given address and check if it is currently open or closed.
- [You.com](https://orthogonal.com/discover/you/skill.md): Real-time web search, content extraction, and deep research APIs for AI agents.