Guides

Examples

Chain multiple APIs into complete workflows

Each example chains two to four tools to complete one task. Every example includes the CLI, Node.js, and Python.

The Node.js and Python workflows reuse the run helper from the first example. Set ORTHOGONAL_API_KEY before running them.

1. Lead Research & Enrichment

Goal: Research a target company and build a complete profile of key contacts.

Tools used: LinkUp (AI search) → Hunter (email finding) → Apollo (enrichment)

# 1. Research the company with AI search
orth run linkup /search --body '{"q": "stripe company funding valuation news 2026", "depth": "standard"}'
# 2. Find contacts at the company
orth run hunter /v2/domain-search -q domain=stripe.com
# 3. Enrich the top contact (use an email from step 2)
orth run apollo /v1/people/match --body '{"email": "founder@stripe.com"}'

2. Competitor Social Intelligence

Goal: Monitor a competitor’s social media presence and extract brand assets.

Tools used: Shofo (social scraping) → Brand.dev (brand extraction) → Olostep (web scraping)

# 1. Recent LinkedIn posts
orth run shofo /linkedin/company-posts --body '{"company_url": "https://linkedin.com/company/notionhq"}'
# 2. Brand assets - logos, colors
orth run brand-dev /v1/brand/retrieve --body '{"domain": "notion.so"}'
# 3. Scrape the pricing page
orth run olostep /v1/scrapes --body '{"url_to_scrape": "https://notion.so/pricing", "formats": ["markdown"]}'

3. Event-Based Prospecting

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

Tools used: Fiber (people search) → Shofo (social activity) → Tomba (email finding)

# 1. Find people matching your ICP
orth run fiber /v1/natural-language-search/profiles --body '{"query": "VP of Sales at Series B SaaS companies in San Francisco", "limit": 10}'
# For each profile from step 1, plug in its linkedin_url:
# 2. Check recent LinkedIn activity
orth run shofo /linkedin/user-posts --body '{"profile_url": "<linkedin_url>"}'
# 3. Find their email
orth run tomba /v1/linkedin --body '{"url": "<linkedin_url>"}'

4. Account-Based Marketing Research

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

Tools used: Brand.dev (company data) → Fiber (find employees) → Apollo (enrich contacts)

# 1. Company brand info and products
orth run brand-dev /v1/brand/retrieve --body '{"domain": "figma.com"}'
# 2. Find decision makers
orth run fiber /v1/natural-language-search/profiles --body '{"query": "executives and VPs at figma.com company", "limit": 5}'
# For each profile from step 2, plug in its linkedin_url:
# 3. Enrich with contact details
orth run apollo /v1/people/match --body '{"linkedin_url": "<linkedin_url>"}'

5. Content & Trigger Monitoring

Goal: Monitor social channels for buying signals and company news.

Tools used: Shofo (X/Twitter monitoring) → LinkUp (news search) → Riveter (structured extraction)

# 1. Recent tweets from the company
orth run shofo /x/user-posts --body '{"username": "stripe"}'
# 2. Recent news and announcements
orth run linkup /search --body '{"q": "stripe.com announcement funding launch 2026", "depth": "standard"}'
# 3. Extract structured triggers from the news text (paste content from step 2)
orth run riveter /v1/run --body '{"input": "<news text>", "output_schema": {"type": "object", "properties": {"funding_events": {"type": "array", "items": {"type": "string"}}, "product_launches": {"type": "array", "items": {"type": "string"}}, "hiring_signals": {"type": "array", "items": {"type": "string"}}, "expansion_news": {"type": "array", "items": {"type": "string"}}}}}'