Orthogonal

https://docs.orthogonal.com
Admin
Orthogonal provides trusted, ready-to-install skills and APIs that make AI agents more capable with...
Tokens:17,881
Snippets:325
Trust Score:6.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example API Calls

Source: https://docs.orthogonal.com/api-reference/details

Examples of how to fetch endpoint details using cURL, Node.js, and Python.

```bash
curl -X POST 'https://api.orthogonal.com/v1/details' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "api": "apollo",
      "path": "/v1/people/match"
    }'
```

```javascript
const response = await fetch('https://api.orthogonal.com/v1/details', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      api: 'apollo',
      path: '/v1/people/match'
    })
  });

  const { api, endpoint } = await response.json();
  console.log(`Price: ${endpoint.price}`);
  console.log('Parameters:', endpoint.bodyParams);
```

```python
import requests
import os

response = requests.post(
    'https://api.orthogonal.com/v1/details',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'},
    json={'api': 'apollo', 'path': '/v1/people/match'}
)

data = response.json()
print(f"Price: {data['endpoint']['price']}")
print('Parameters:', data['endpoint']['bodyParams'])
```

--------------------------------

### Chain Multiple APIs

Source: https://docs.orthogonal.com/quickstart

This code snippet demonstrates chaining APIs to find an email and then get a phone number.

```bash
# Find email → Get phone number
# Step 1: Find email
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"api": "sixtyfour", "path": "/find-email", "body": {"lead_info": {"first_name": "Patrick", "last_name": "Collison", "company_domain": "stripe.com"}}}'

# Step 2: Get phone using that email
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"api": "sixtyfour", "path": "/find-phone", "body": {"lead_info": {"email": "patrick@stripe.com"}}}'
```

--------------------------------

### Install the CLI

Source: https://docs.orthogonal.com/cli

Install the Orthogonal CLI globally using npm.

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

--------------------------------

### Get Details - Example

Source: https://docs.orthogonal.com/agent-platforms

Example request body for the get_details tool.

```json
{
  "api": "olostep",
  "path": "/v1/scrapes"
}
```

--------------------------------

### Python Example

Source: https://docs.orthogonal.com/api-reference/balance

Example of how to fetch the balance using Python.

```python
import requests
import os

response = requests.get(
    'https://api.orthogonal.com/v1/credits/balance',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'}
)

balance = response.json()
print(f"Balance: {balance['balance']}")
```

--------------------------------

### CLI Example

Source: https://docs.orthogonal.com/api-reference/balance

Example of how to fetch the balance using the Orthogonal CLI.

```bash
orth balance
```

--------------------------------

### Node.js Example

Source: https://docs.orthogonal.com/api-reference/balance

Example of how to fetch the balance using Node.js.

```javascript
const response = await fetch('https://api.orthogonal.com/v1/credits/balance', {
  headers: {
    'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`
  }
});

const { balance } = await response.json();
console.log(`Balance: ${balance}`);
```

--------------------------------

### Install a Skill

Source: https://docs.orthogonal.com/cli

Install a skill to your AI agent's directory.

```bash
orth skills install company-intel
```

--------------------------------

### CLI Commands

Source: https://docs.orthogonal.com/skill

Examples of using the 'orth' CLI for various operations like searching for APIs, viewing endpoint details, executing API calls, checking account balance, and installing skills.

```bash
orth search "web scraping"              # Find APIs
orth api olostep                        # View endpoints for an API
orth api olostep /v1/scrapes            # Get endpoint details
orth run olostep /v1/scrapes --body '{...}'  # Execute API call
orth account                            # Check balance and usage
orth skills install company-intel      # Install skill to agent
```

--------------------------------

### Building Dynamic Requests

Source: https://docs.orthogonal.com/api-reference/details

Example of using the 'getDetails' function to programmatically construct and make API calls.

```javascript
// 1. Get endpoint details
const details = await getDetails('apollo', '/v1/people/match');

// 2. Build request body from available params
const body = {};
for (const param of details.endpoint.bodyParams) {
  if (userInput[param.name]) {
    body[param.name] = userInput[param.name];
  }
}

// 3. Make the API call
const result = await run('apollo', '/v1/people/match', { body });
```

--------------------------------

### cURL Example

Source: https://docs.orthogonal.com/api-reference/balance

Example of how to fetch the balance using cURL.

```bash
curl 'https://api.orthogonal.com/v1/credits/balance' \
    -H 'Authorization: Bearer YOUR_API_KEY'
```

--------------------------------

### Get Details API Response Example

Source: https://docs.orthogonal.com/mcp/tools

Example JSON response from the get_details tool, showing detailed information about a specific API endpoint.

```json
{
  "success": true,
  "api": {
    "name": "Apollo.io",
    "slug": "apollo",
    "description": "B2B lead enrichment and contact database"
  },
  "endpoint": {
    "path": "/v1/people/match",
    "method": "POST",
    "description": "Enrich a person by email, name, or LinkedIn URL",
    "price": "$0.03",
    "isPayable": true,
    "bodyParams": [
      {
        "name": "email",
        "type": "string",
        "required": false,
        "description": "Email address to enrich"
      }
    ]
  }
}
```

--------------------------------

### Response JSON

Source: https://docs.orthogonal.com/api-reference/details

Example JSON response when fetching details for an API endpoint.

```json
{
  "success": true,
  "api": {
    "name": "Apollo.io",
    "slug": "apollo",
    "description": "B2B lead enrichment and contact database",
    "baseUrl": "https://api.apollo.io",
    "verified": true
  },
  "endpoint": {
    "path": "/v1/people/match",
    "method": "POST",
    "description": "Enrich a person by email, name, or LinkedIn URL",
    "price": "$0.03",
    "isPayable": true,
    "docsUrl": "https://apolloio.github.io/apollo-api-docs",
    "bodyType": "object",
    "pathParams": [],
    "queryParams": [],
    "bodyParams": [
      {
        "name": "email",
        "type": "string",
        "required": false,
        "description": "Email address to enrich"
      },
      {
        "name": "first_name",
        "type": "string",
        "required": false,
        "description": "First name of the person"
      },
      {
        "name": "last_name",
        "type": "string",
        "required": false,
        "description": "Last name of the person"
      },
      {
        "name": "organization_name",
        "type": "string",
        "required": false,
        "description": "Company name"
      },
      {
        "name": "linkedin_url",
        "type": "string",
        "required": false,
        "description": "LinkedIn profile URL"
      }
    ]
  },
  "usage": {
    "runApi": "POST /v1/run with {\"api\": \"apollo\", \"path\": \"/v1/people/match\", ...}",
    "x402": "https://x402.orth.sh/apollo/v1/people/match"
  }
}
```

--------------------------------

### cURL Example

Source: https://docs.orthogonal.com/api-reference/integrate

Example of how to use cURL to integrate an API endpoint.

```bash
curl -X POST 'https://api.orthogonal.com/v1/integrate' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "api": "hunter",
      "path": "/domain-search",
      "format": "all"
    }'
```

--------------------------------

### Call the API

Source: https://docs.orthogonal.com/quickstart

This code snippet shows how to use the Run API to enrich a lead.

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{ \
      "api": "sixtyfour", \
      "path": "/enrich-lead", \
      "body": { \
        "lead_info": { \
          "first_name": "Patrick", \
          "last_name": "Collison", \
          "company_domain": "stripe.com" \
        } \
      } \
    }'
```

```javascript
const response = await fetch('https://api.orthogonal.com/v1/run', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      api: 'sixtyfour',
      path: '/enrich-lead',
      body: {
        lead_info: {
          first_name: 'Patrick',
          last_name: 'Collison',
          company_domain: 'stripe.com'
        }
      }
    })
  });

  const { data, price } = await response.json();
  console.log(`Cost: $${price}`);
  console.log(data);
```

```python
import requests

response = requests.post(
    'https://api.orthogonal.com/v1/run',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'api': 'sixtyfour',
        'path': '/enrich-lead',
        'body': {
            'lead_info': {
                'first_name': 'Patrick',
                'last_name': 'Collison',
                'company_domain': 'stripe.com'
            }
        }
    }
)

result = response.json()
print(f"Cost: ${result['price']}")
print(result['data'])
```

--------------------------------

### Run API Example

Source: https://docs.orthogonal.com/api-reference/search

Example of how to use search results with the Run API.

```bash
# From search: slug="apollo", path="/v1/people/match"
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "api": "apollo",
    "path": "/v1/people/match",
    "body": {"email": "ceo@stripe.com"}
  }'
```

--------------------------------

### Search for an API

Source: https://docs.orthogonal.com/quickstart

This code snippet demonstrates how to search for APIs related to lead enrichment.

```bash
curl -X POST 'https://api.orthogonal.com/v1/search' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{"prompt": "enrich lead find email", "limit": 5}'
```

```javascript
const response = await fetch('https://api.orthogonal.com/v1/search', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      prompt: 'enrich lead find email',
      limit: 5
    })
  });

  const { results } = await response.json();
  console.log(results);
```

```python
import requests

response = requests.post(
    'https://api.orthogonal.com/v1/search',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={'prompt': 'enrich lead find email', 'limit': 5}
)

results = response.json()['results']
print(results)
```

--------------------------------

### Example API Calls

Source: https://docs.orthogonal.com/api-reference/usage

Examples of how to fetch API usage data using cURL, the Orthogonal CLI, Node.js, and Python.

```bash
# Last 7 days of usage
curl 'https://api.orthogonal.com/v1/credits/usage?days=7&limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```bash
# Default: last 30 days
orth usage

# Last 7 days, 10 results
orth usage --days 7 --limit 10
```

```javascript
const response = await fetch('https://api.orthogonal.com/v1/credits/usage?days=7', {
  headers: {
    'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`
  }
});

const { usage, totalSpent } = await response.json();
console.log(`Total spent: ${totalSpent}`);
console.log(`API calls: ${usage.length}`);
```

```python
import requests
import os

response = requests.get(
    'https://api.orthogonal.com/v1/credits/usage',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'},
    params={'days': 7, 'limit': 20}
)

data = response.json()
print(f"Spent {data['totalSpent']} across {data['pagination']['total']} calls")
```

--------------------------------

### Node.js Example

Source: https://docs.orthogonal.com/api-reference/integrate

Example of how to integrate an API endpoint using Node.js fetch.

```javascript
const response = await fetch('https://api.orthogonal.com/v1/integrate', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      api: 'hunter',
      path: '/domain-search',
      format: 'curl'
    })
  });

  const { snippets } = await response.json();
  console.log(snippets.curl);
```

--------------------------------

### Run API - Example

Source: https://docs.orthogonal.com/agent-platforms

Example request body for the run_api tool.

```json
{
  "api": "apollo",
  "path": "/v1/people/match",
  "body": {
    "email": "ceo@stripe.com"
  }
}
```

--------------------------------

### Example Multi-API Workflow

Source: https://docs.orthogonal.com/mcp/tools

An example of a user request and the agent's step-by-step API calls to fulfill it.

```text
User: Research Stripe and find contact info for their leadership team

Agent:
1. *search* "AI web search company research" → finds LinkUp
2. *use* linkup /v1/search → gets company info and news
3. *search* "lead enrichment email" → finds Apollo, Hunter
4. *use* apollo /v1/people/match → enriches CEO by email
5. *use* hunter /domain-search → finds more contacts at stripe.com

Result: Complete company research + contacts
```

--------------------------------

### Python Example

Source: https://docs.orthogonal.com/api-reference/search

Example of how to call the Search API using Python.

```python
import requests
import os

response = requests.post(
    'https://api.orthogonal.com/v1/search',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'},
    json={'prompt': 'enrich lead find email', 'limit': 5}
)

results = response.json()['results']

# Get verified endpoints only
verified = [ep for api in results for ep in api['endpoints'] if ep.get('verified')]
print(f"Found {len(verified)} verified endpoints")
```

--------------------------------

### Pagination Example

Source: https://docs.orthogonal.com/api-reference/list-endpoints

Example of how to fetch all APIs using pagination with JavaScript.

```javascript
async function getAllApis() {
  const allApis = [];
  let offset = 0;
  const limit = 100;
  
  while (true) {
    const response = await fetch(
      `https://api.orthogonal.com/v1/list-endpoints?limit=${limit}&offset=${offset}`,
      { headers: { 'Authorization': `Bearer ${apiKey}` } }
    );
    const { apis, pagination } = await response.json();
    
    allApis.push(...apis);
    
    if (!pagination.hasMore) break;
    offset += limit;
  }
  
  return allApis;
}
```

--------------------------------

### Node.js Example

Source: https://docs.orthogonal.com/api-reference/search

Example of how to call the Search API using Node.js.

```javascript
const response = await fetch('https://api.orthogonal.com/v1/search', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'enrich lead find email',
    limit: 5
  })
});

const { results } = await response.json();

// Get verified endpoints only
const verified = results.flatMap(api => 
  api.endpoints.filter(ep => ep.verified)
);
console.log('Verified endpoints:', verified);
```

--------------------------------

### Example: Search the web

Source: https://docs.orthogonal.com/cli

Use the CLI to search the web with specific parameters.

```bash
orth run tavily /search --body '{
  "query": "latest AI news",
  "search_depth": "advanced"
}'
```

--------------------------------

### Install skills from the catalog with one command

Source: https://docs.orthogonal.com/

Use the Orth CLI to add skills to your agent.

```bash
# Using the Orth CLI
orth skills add linkedin-scraper

```

--------------------------------

### cURL Examples

Source: https://docs.orthogonal.com/api-reference/list-endpoints

Examples of how to list APIs and paginate through results using cURL.

```bash
# List all APIs
curl 'https://api.orthogonal.com/v1/list-endpoints' \
  -H 'Authorization: Bearer YOUR_API_KEY'

# Paginate through results
curl 'https://api.orthogonal.com/v1/list-endpoints?limit=50&offset=50' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

--------------------------------

### Search APIs - Example

Source: https://docs.orthogonal.com/agent-platforms

Example request body for the search_apis tool.

```json
{
  "prompt": "enrich lead by email",
  "limit": 5
}
```

--------------------------------

### Check Sufficiency cURL Example

Source: https://docs.orthogonal.com/api-reference/balance

Example of how to check balance sufficiency using cURL.

```bash
curl -X POST 'https://api.orthogonal.com/v1/credits/check' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"amountCents": 100}'
```

--------------------------------

### cURL Example

Source: https://docs.orthogonal.com/api-reference/search

Example of how to call the Search API using cURL.

```bash
curl -X POST 'https://api.orthogonal.com/v1/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "enrich lead find email",
    "limit": 5
  }'
```

--------------------------------

### Example: Verify an email

Source: https://docs.orthogonal.com/cli

Use the CLI to verify an email address.

```bash
orth run tomba /v1/email-verifier -q email=hello@orthogonal.com
```

--------------------------------

### Python Example

Source: https://docs.orthogonal.com/api-reference/transactions

Example of how to fetch transaction history using Python.

```python
import requests
import os

response = requests.get(
    'https://api.orthogonal.com/v1/credits/transactions',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'},
    params={'limit': 20}
)

transactions = response.json()['transactions']
for tx in transactions:
    amount = tx['amountCents'] / 100000
    print(f"{tx['type']:12} ${amount:+.4f}  {tx['description']}")
```

--------------------------------

### Python Example

Source: https://docs.orthogonal.com/api-reference/integrate

Example of how to integrate an API endpoint using Python requests.

```python
import requests
import os

response = requests.post(
    'https://api.orthogonal.com/v1/integrate',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'},
    json={'api': 'hunter', 'path': '/domain-search', 'format': 'all'}
)

snippets = response.json()['snippets']
```

--------------------------------

### API Call Pricing Example

Source: https://docs.orthogonal.com/concepts/pricing

This JSON object shows an example of how API pricing is represented, including the API name, path, price, and a description.

```json
{
  "api": "apollo",
  "path": "/v1/people/match",
  "price": 0.03,
  "description": "Enrich a person by email"
}
```

--------------------------------

### Node.js Example

Source: https://docs.orthogonal.com/api-reference/transactions

Example of how to fetch transaction history using Node.js.

```javascript
const response = await fetch('https://api.orthogonal.com/v1/credits/transactions?limit=20', {
    headers: {
      'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`
    }
  });

  const { transactions } = await response.json();

  // Separate charges and purchases
  const charges = transactions.filter(t => t.amountCents < 0);
  const purchases = transactions.filter(t => t.amountCents > 0);
  console.log(`${charges.length} charges, ${purchases.length} purchases`);
```

--------------------------------

### Python Example

Source: https://docs.orthogonal.com/api-reference/list-endpoints

Example of how to list APIs and filter for verified APIs using Python.

```python
import requests
import os

response = requests.get(
    'https://api.orthogonal.com/v1/list-endpoints',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'}
)

data = response.json()
print(f"Found {data['count']} APIs with {data['totalEndpoints']} total endpoints")

# List all verified APIs
verified = [api for api in data['apis'] if api['verified']]
print(f"Verified APIs: {[api['name'] for api in verified]}")
```

--------------------------------

### Use API Response Example

Source: https://docs.orthogonal.com/mcp/tools

Example JSON response from the use tool, showing the results of an executed API call.

```json
{
  "success": true,
  "priceCents": 0.4,
  "data": {
    "results": [
      {
        "title": "Stripe raises $6.5B at $50B valuation",
        "url": "https://...",
        "content": "..."
      }
    ]
  },
  "requestId": "run_1234567890_abc123"
}
```

--------------------------------

### Search API Response Example

Source: https://docs.orthogonal.com/mcp/tools

Example JSON response from the search tool, listing available APIs and their endpoints.

```json
{
  "success": true,
  "results": [
    {
      "id": "api-uuid",
      "name": "Apollo.io",
      "slug": "apollo",
      "baseUrl": "https://api.apollo.io",
      "endpoints": [
        {
          "id": "endpoint-uuid",
          "path": "/v1/people/match",
          "method": "POST",
          "description": "Enrich a person by email, name, or LinkedIn URL",
          "price": "0.03",
          "isPayable": true,
          "score": 0.95
        },
        {
          "path": "/v1/organizations/enrich",
          "description": "Enrich a company by domain",
          "price": "0.03"
        }
      ]
    }
  ],
  "count": 2,
  "apisCount": 1
}
```

--------------------------------

### cURL Example

Source: https://docs.orthogonal.com/api-reference/transactions

Example of how to fetch transaction history using cURL.

```bash
curl 'https://api.orthogonal.com/v1/credits/transactions?limit=20' \
    -H 'Authorization: Bearer YOUR_API_KEY'
```

--------------------------------

### Node.js Example

Source: https://docs.orthogonal.com/api-reference/list-endpoints

Example of how to list APIs and filter for specific endpoints using Node.js.

```javascript
const response = await fetch('https://api.orthogonal.com/v1/list-endpoints', {
  headers: {
    'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`
  }
});

const { apis, totalEndpoints } = await response.json();
console.log(`Found ${apis.length} APIs with ${totalEndpoints} total endpoints`);

// List all scraping endpoints
const scrapingEndpoints = apis.flatMap(api => 
  api.endpoints.filter(ep => 
    ep.description?.toLowerCase().includes('scrape')
  ).map(ep => ({ api: api.slug, ...ep }))
);
```

--------------------------------

### Example Workflow: Finding CEO's Email

Source: https://docs.orthogonal.com/agent-platforms

An example of how an agent uses the provided tools to find the CEO's email at a specific company.

```json
{"prompt": "find email for person", "limit": 3}
```

```json
{
  "api": "hunter",
  "path": "/email-finder",
  "body": {
    "first_name": "Patrick",
    "last_name": "Collison",
    "domain": "stripe.com"
  }
}
```

--------------------------------

### Example: Scrape a webpage

Source: https://docs.orthogonal.com/cli

Use the CLI to scrape a webpage and specify output formats.

```bash
orth run olostep /v1/scrapes --body '{
  "url_to_scrape": "https://example.com",
  "formats": ["markdown"]
}'
```

--------------------------------

### Example: Find someone's email

Source: https://docs.orthogonal.com/cli

Use the CLI to find a person's email address.

```bash
orth run hunter /v2/email-finder -q domain=stripe.com -q first_name=Patrick -q last_name=Collison
```

--------------------------------

### Web Scraping (Olostep)

Source: https://docs.orthogonal.com/api-reference/run

Example of scraping a URL using the Olostep API.

```cURL
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "api": "olostep",
    "path": "/v1/scrapes",
    "body": {
      "url_to_scrape": "https://stripe.com/about"
    }
  }'
```

--------------------------------

### Integrate API Response Example (Curl)

Source: https://docs.orthogonal.com/mcp/tools

Example JSON response from the integrate tool, providing a curl command to call an endpoint.

```json
{
  "success": true,
  "api": {
    "name": "Olostep",
    "slug": "olostep"
  },
  "endpoint": {
    "path": "/v1/scrapes",
    "method": "POST",
    "price": "$0.005"
  },
  "format": "curl",
  "snippets": {
    "curl": "curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{\"api\": \"olostep\", \"path\": \"/v1/scrapes\", \"body\": {\"url_to_scrape\": \"https://example.com\"}}'"
  }
}
```

--------------------------------

### View Endpoint Details

Source: https://docs.orthogonal.com/cli

Get full parameter details for an API endpoint.

```bash
orth api olostep /v1/scrapes
```

--------------------------------

### API Not Found (404) Error Response

Source: https://docs.orthogonal.com/api-reference/run

Example JSON response for an API not found error.

```json
{
  "success": false,
  "error": "API not found: invalid-slug"
}
```

--------------------------------

### Insufficient Credits (402) Error Response

Source: https://docs.orthogonal.com/api-reference/run

Example JSON response for insufficient credits.

```json
{
  "success": false,
  "priceCents": 10,
  "error": "Insufficient credits. Cost: $0.10, Available: $0.02"
}
```

--------------------------------

### Lead Enrichment (Apollo)

Source: https://docs.orthogonal.com/api-reference/run

Example of enriching a lead using the Apollo API.

```cURL
curl -X POST 'https://api.orthogonal.com/v1/run' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "api": "apollo",
      "path": "/v1/people/match",
      "body": {
        "email": "ceo@stripe.com"
      }
    }'
```

```javascript
const response = await fetch('https://api.orthogonal.com/v1/run', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      api: 'apollo',
      path: '/v1/people/match',
      body: {
        email: 'ceo@stripe.com'
      }
    })
  });

  const { success, priceCents, data } = await response.json();
  console.log(`Enriched for $${(priceCents / 100).toFixed(2)}`);
  console.log(data);
```

```python
import requests
import os

response = requests.post(
    'https://api.orthogonal.com/v1/run',
    headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'},
    json={
        'api': 'apollo',
        'path': '/v1/people/match',
        'body': {
            'email': 'ceo@stripe.com'
        }
    }
)

result = response.json()
print(f"Enriched for ${result['priceCents'] / 100:.2f}")
print(result['data'])
```

--------------------------------

### Discovery API - Integrate

Source: https://docs.orthogonal.com/api-reference/introduction

Get code snippets

```http
POST   /v1/integrate
```

--------------------------------

### Response from /v1/run

Source: https://docs.orthogonal.com/skill

Example JSON response structure from the /v1/run endpoint, including success status, price, data, and request ID.

```json
{
  "success": true,
  "priceCents": 10,
  "data": { /* API response */ },
  "requestId": "run_xxxxx"
}
```

--------------------------------

### Response JSON

Source: https://docs.orthogonal.com/api-reference/search

Example of a successful response from the Search API.

```json
{
  "success": true,
  "results": [
    {
      "id": "api-uuid",
      "name": "Apollo.io",
      "slug": "apollo",
      "baseUrl": "https://api.apollo.io",
      "payableBaseUrl": "https://api.orthogonal.com/pay/apollo",
      "endpoints": [
        {
          "id": "endpoint-uuid",
          "path": "/v1/people/match",
          "method": "POST",
          "description": "Enrich a person by email, name, or LinkedIn URL",
          "price": "0.03",
          "isPayable": true,
          "verified": true,
          "score": 0.95
        },
        {
          "path": "/v1/organizations/enrich",
          "method": "POST",
          "description": "Enrich a company by domain",
          "price": "0.03",
          "verified": true,
          "score": 0.90
        }
      ]
    },
    {
      "id": "api-uuid-2",
      "name": "Hunter.io",
      "slug": "hunter",
      "endpoints": [
        {
          "path": "/domain-search",
          "method": "POST",
          "description": "Find email addresses for a company domain",
          "price": "0.01",
          "verified": true,
          "score": 0.85
        }
      ]
    }
  ],
  "count": 3,
  "apisCount": 2,
  "prompt": "enrich lead with contact info",
  "searchType": "semantic",
  "responseTime": 145
}
```

--------------------------------

### Claude Desktop Configuration

Source: https://docs.orthogonal.com/mcp/setup

Add the Orthogonal MCP server to your Claude Desktop configuration.

```json
{
  "mcpServers": {
    "orthogonal": {
      "url": "https://mcp.orth.sh"
    }
  }
}
```

--------------------------------

### Get Details - Request Body

Source: https://docs.orthogonal.com/agent-platforms

Request body for the get_details tool.

```json
{
  "api": "string (required) - API slug",
  "path": "string (required) - Endpoint path"
}
```

--------------------------------

### AI Web Search (LinkUp)

Source: https://docs.orthogonal.com/api-reference/run

Example of performing an AI web search using the LinkUp API.

```cURL
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "api": "linkup",
    "path": "/v1/search",
    "body": {
      "q": "latest Series A funding rounds fintech 2026",
      "depth": "standard"
    }
  }'
```

--------------------------------

### Request to /v1/run

Source: https://docs.orthogonal.com/skill

Example JSON payload for the /v1/run endpoint, specifying the API, path, and request body/query parameters.

```json
{
  "api": "sixtyfour",
  "path": "/enrich-lead",
  "body": { "lead_info": { "email": "user@example.com" } },
  "query": { "optional_param": "value" }
}
```

--------------------------------

### API Response Cost Example

Source: https://docs.orthogonal.com/concepts/pricing

This JSON object illustrates how the cost of an API call is included in the response.

```json
{
  "success": true,
  "priceCents": 0.5,
  "data": { ... }
}
```

--------------------------------

### Get endpoint details

Source: https://docs.orthogonal.com/skill

Use the /v1/details endpoint to understand the parameters for a chosen API endpoint.

```bash
curl -X POST 'https://api.orthogonal.com/v1/details' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -d '{"api": "sixtyfour", "path": "/enrich-lead"}'
```

--------------------------------

### Response JSON

Source: https://docs.orthogonal.com/api-reference/list-endpoints

Example JSON response structure for listing APIs and their endpoints.

```json
{
  "success": true,
  "apis": [
    {
      "name": "Olostep",
      "slug": "olostep",
      "description": "Web scraping and content extraction API",
      "baseUrl": "https://api.olostep.com",
      "verified": true,
      "endpoints": [
        {
          "path": "/v1/scrapes",
          "method": "POST",
          "description": "Scrape any webpage and get clean markdown",
          "price": "$0.005",
          "isPayable": true,
          "docsUrl": "https://docs.olostep.com/api/scrape",
          "queryParams": [],
          "bodyParams": [
            {
              "name": "url",
              "type": "string",
              "required": true,
              "description": "URL to scrape"
            }
          ]
        }
      ]
    },
    {
      "name": "Hunter.io",
      "slug": "hunter",
      "description": "Email finder and verification",
      "baseUrl": "https://api.hunter.io/v2",
      "verified": true,
      "endpoints": [
        {
          "path": "/domain-search",
          "method": "POST",
          "description": "Find email addresses for a domain",
          "price": "$0.01",
          "isPayable": true
        }
      ]
    }
  ],
  "count": 2,
  "totalEndpoints": 2,
  "pagination": {
    "limit": 100,
    "offset": 0,
    "hasMore": false
  }
}
```

--------------------------------

### List All APIs

Source: https://docs.orthogonal.com/cli

List all available APIs using the 'api' command.

```bash
orth api
```

--------------------------------

### x402 Payment Handling with JavaScript

Source: https://docs.orthogonal.com/concepts/pricing

This JavaScript code snippet demonstrates how to use the `x402-fetch` library to automatically handle 402 Payment Required responses when making API calls.

```javascript
import { wrapFetchWithPayment } from 'x402-fetch';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPayment(fetch, account);

// Automatically handles 402 responses
const response = await fetchWithPayment('https://x402.orth.sh/api/endpoint');

```

--------------------------------

### View Account Info

Source: https://docs.orthogonal.com/cli

Check your account balance and usage.

```bash
orth account
```

--------------------------------

### Quick Reference - Integration Configuration

Source: https://docs.orthogonal.com/agent-platforms

YAML configuration for integrating Orthogonal.

```yaml
# Integration Configuration
name: Orthogonal
description: Search and use paid APIs with one API key
base_url: https://api.orthogonal.com/v1

# Authentication
auth_type: bearer
auth_header: Authorization
auth_value: Bearer {{api_key}}


```

--------------------------------

### Discovery API - Details

Source: https://docs.orthogonal.com/api-reference/introduction

Get endpoint parameters

```http
POST   /v1/details
```

--------------------------------

### Store API Key in Environment Variable

Source: https://docs.orthogonal.com/authentication

We recommend storing your key in an environment variable.

```bash
export ORTHOGONAL_API_KEY=orth_live_xxxxxxxxxxxx
```

--------------------------------

### Response JSON

Source: https://docs.orthogonal.com/api-reference/transactions

Example JSON response for the transactions endpoint.

```json
{
  "transactions": [
    {
      "id": "tx_abc123",
      "type": "api_call",
      "amountCents": -3000,
      "description": "API call: apollo /v1/people/match",
      "timestamp": "2026-02-27T10:30:00Z",
      "metadata": {
        "api": "apollo",
        "path": "/v1/people/match"
      }
    },
    {
      "id": "tx_def456",
      "type": "purchase",
      "amountCents": 1000000,
      "description": "Credit purchase: 10,000 credits",
      "timestamp": "2026-02-25T14:00:00Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 2
  }
}
```

--------------------------------

### View Skill Details

Source: https://docs.orthogonal.com/cli

View details for a specific skill.

```bash
orth skills show company-intel
```

--------------------------------

### List Skills

Source: https://docs.orthogonal.com/cli

List available skills for your AI agent.

```bash
orth skills
```

--------------------------------

### Search APIs

Source: https://docs.orthogonal.com/cli

Find APIs by keyword using the search command.

```bash
orth search "web scraping"
```

--------------------------------

### Run API - Execute

Source: https://docs.orthogonal.com/api-reference/introduction

Call any API endpoint

```http
POST   /v1/run
```

--------------------------------

### Get Code Snippets - Request Body

Source: https://docs.orthogonal.com/agent-platforms

Request body for the get_code tool.

```json
{
  "api": "string (required) - API slug",
  "path": "string (required) - Endpoint path",
  "format": "string (optional) - curl, run-api, x402-fetch, x402-python, all"
}
```

--------------------------------

### Add to Claude Desktop, Cursor, or any MCP client

Source: https://docs.orthogonal.com/

Configure MCP servers to access Orthogonal skills.

```json
{
  "mcpServers": {
    "orthogonal": {
      "url": "https://mcp.orth.sh"
    }
  }
}

```

--------------------------------

### View API Endpoints

Source: https://docs.orthogonal.com/cli

See all endpoints for a specific API.

```bash
orth api olostep
```

--------------------------------

### Account-Based Marketing Research

Source: https://docs.orthogonal.com/use-cases

Deep-dive on a target account - company intel, key people, and their social presence.

```Node.js
async function abmResearch(targetDomain) {
    // Step 1: Get company brand info and products
    const company = await run('brand-dev', '/v1/brand/retrieve', {
      domain: targetDomain
    });
    
    // Step 2: Find decision makers
    const people = await run('fiber', '/v1/natural-language-search/profiles', {
      query: `executives and VPs at ${targetDomain} company`,
      limit: 5
    });
    
    // Step 3: Enrich each person with contact details
    const enrichedPeople = [];
    for (const person of people.data?.profiles || []) {
      const enriched = await run('apollo', '/v1/people/match', {
        linkedin_url: person.linkedin_url
      });
      enrichedPeople.push({
        ...person,
        contact: enriched.data?.person
      });
    }
    
    return {
      company: company.data,
      decisionMakers: enrichedPeople
    };
  }


  const account = await abmResearch('figma.com');
  
```

```Python
def abm_research(target_domain):
    # Step 1: Get company brand info and products
    company = run('brand-dev', '/v1/brand/retrieve', {
        'domain': target_domain
    })
    
    # Step 2: Find decision makers
    people = run('fiber', '/v1/natural-language-search/profiles', {
        'query': f'executives and VPs at {target_domain} company',
        'limit': 5
    })
    
    # Step 3: Enrich each person with contact details
    enriched_people = []
    for person in people.get('data', {}).get('profiles', []):
        enriched = run('apollo', '/v1/people/match', {
            'linkedin_url': person['linkedin_url']
        })
        enriched_people.append({
            **person,
            'contact': enriched.get('data', {}).get('person')
        })
    
    return {
        'company': company['data'],
        'decision_makers': enriched_people
    }


  account = abm_research('figma.com')
  
```

--------------------------------

### Call an API with Query Parameters

Source: https://docs.orthogonal.com/cli

Execute an API endpoint with query parameters.

```bash
orth run hunter /v2/domain-search -q domain=orthogonal.com
```

--------------------------------

### Response JSON Structure

Source: https://docs.orthogonal.com/api-reference/integrate

The response from the /v1/integrate endpoint includes various code snippets for different formats, along with setup instructions.

```json
{
  "success": true,
  "api": {
    "name": "Olostep",
    "slug": "olostep"
  },
  "endpoint": {
    "path": "/v1/scrapes",
    "method": "POST",
    "price": "$0.005"
  },
  "format": "all",
  "snippets": {
    "orth-sdk": "import Orthogonal from \"@orth/sdk\";\n\nconst orthogonal = new Orthogonal(...);\nconst result = await orthogonal.run({...});",
    "run-api": "curl -X POST 'https://api.orthogonal.com/v1/run' ...",
    "curl": "curl -X POST 'https://api.orthogonal.com/v1/run' ...",
    "x402-fetch": "import { wrapFetchWithPayment } from \"x402-fetch\"; ...",
    "x402-python": "from x402.clients.requests import x402_http_adapter ..."
  },
  "setup": {
    "sdk": "npm install @orth/sdk && export ORTHOGONAL_API_KEY=orth_live_...",
    "x402": "npm install x402-fetch viem && export PRIVATE_KEY=0x..."
  }
}
```

--------------------------------

### List All APIs - Query Parameters

Source: https://docs.orthogonal.com/agent-platforms

Query parameters for the list_apis tool.

```text
limit: number (optional) - Max APIs to return, default 100
offset: number (optional) - Pagination offset
```

--------------------------------

### Search for APIs

Source: https://docs.orthogonal.com/skill

Use the /v1/search endpoint to find matching APIs with a natural language prompt.

```bash
curl -X POST 'https://api.orthogonal.com/v1/search' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -d '{"prompt": "enrich lead find email", "limit": 5}'
```

--------------------------------

### Use the Orthogonal API directly for programmatic access

Source: https://docs.orthogonal.com/

Set your Orthogonal API key for direct programmatic access.

```bash
export ORTHOGONAL_API_KEY=orth_live_your_key

```

--------------------------------

### Execute the call

Source: https://docs.orthogonal.com/skill

Use the /v1/run endpoint with the API slug, path, and parameters to execute an API call.

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -d '{"api": "sixtyfour", "path": "/enrich-lead", "body": {...}}'
```

--------------------------------

### Event-Based Prospecting

Source: https://docs.orthogonal.com/use-cases

Find people who recently engaged with relevant content and enrich them for outreach.

```Node.js
async function findEngagedProspects(criteria) {
    // Step 1: Find people matching your ICP
    const prospects = await run('fiber', '/v1/natural-language-search/profiles', {
      query: criteria,
      limit: 10
    });
    
    const enrichedProspects = [];
    
    for (const person of prospects.data?.profiles || []) {
      // Step 2: Check their recent LinkedIn activity
      const activity = await run('shofo', '/linkedin/user-posts', {
        profile_url: person.linkedin_url
      });
      
      // Step 3: Find their email
      const email = await run('tomba', '/v1/linkedin', {
        url: person.linkedin_url
      });
      
      enrichedProspects.push({
        ...person,
        recentPosts: activity.data?.posts?.slice(0, 3),
        email: email.data?.data?.email
      });
    }
    
    return enrichedProspects;
  }


  const prospects = await findEngagedProspects(
    'VP of Sales at Series B SaaS companies in San Francisco'
  );
  
```

```Python
def find_engaged_prospects(criteria):
    # Step 1: Find people matching your ICP
    prospects = run('fiber', '/v1/natural-language-search/profiles', {
        'query': criteria,
        'limit': 10
    })
    
    enriched_prospects = []
    
    for person in prospects.get('data', {}).get('profiles', []):
        # Step 2: Check their recent LinkedIn activity
        activity = run('shofo', '/linkedin/user-posts', {
            'profile_url': person['linkedin_url']
        })
        
        # Step 3: Find their email
        email = run('tomba', '/v1/linkedin', {
            'url': person['linkedin_url']
        })
        
        enriched_prospects.append({
            **person,
            'recent_posts': activity.get('data', {}).get('posts', [])[:3],
            'email': email.get('data', {}).get('data', {}).get('email')
        })
    
    return enriched_prospects


  prospects = find_engaged_prospects(
      'VP of Sales at Series B SaaS companies in San Francisco'
  )
  
```

--------------------------------

### Available Tools

Source: https://docs.orthogonal.com/agent-platforms

A list of tools available to the agent platform, including their names, HTTP methods, paths, and expected request body or query parameters.

```yaml
tools:
  - name: search_apis
    method: POST
    path: /search
    body: { prompt: string, limit?: number }
    
  - name: run_api
    method: POST
    path: /run
    body: { api: string, path: string, body?: object, query?: object }
    
  - name: get_details
    method: POST
    path: /details
    body: { api: string, path: string }
    
  - name: get_code
    method: POST
    path: /integrate
    body: { api: string, path: string, format?: string }
    
  - name: list_apis
    method: GET
    path: /list-endpoints
    query: { limit?: number, offset?: number }
```
Tokens:
Raw