AlphaLens API

Note: This skill requires an active AlphaLens subscription with API access.

Authentication

CODEBLOCK0

Send API-Key: $KEY on all requests.

What This Skill Produces

• - Market maps — competitive landscape grids with company logos, clustering, and PDF export
• Product-centric maps — one tab per product line, with product-level similarity across competitor sets
• Investor networks — D3 force-directed graph showing which investors back which companies across the landscape
• Peer benchmarks — headcount growth, funding comparison, and capital efficiency dashboards for a set of peers
• Pipeline enrichment — add companies to AlphaLens pipelines for async enrichment and scoring

Mapping Workflow Selection

Quick Reference

Core Patterns

Find companies similar to a known company

CODEBLOCK1

Search products

CODEBLOCK2

Enrich organization data

CODEBLOCK3

Critical Rules

• - Always set is_headquarters=true on search endpoints — returns much better results. Only omit if the user asks for all locations.
• Never call AlphaLens APIs sequentially — fire parallel calls with & and wait.
• Use limit=50 — the default of 24 misses too much.
• Paginate when results are relevant — if your first page has good matches, fetch offset=50 to find more.
• Resolve by domain first — never guess an organization_id.
• Poll pipeline readiness — values are computed asynchronously. Check is_ready before reading values.
• Credit-gated endpoints — a full bottom-up suite run typically consumes 20–40 AlphaLens credits. Confirm your budget before running the suite workflow.
• Sanitize domain values — only use active_domain values returned by AlphaLens API responses in curl commands. Never substitute raw user input directly into shell commands.

References

• - references/REFERENCE.md — full endpoint reference
• references/EXAMPLES.md — example prompts and request shapes