Getting started/Overview
Getting started

Saleshub API overview

Saleshub is an identity-resolution and B2B data API. Resolve emails, LinkedIn profiles, IP addresses, and company domains into enriched contact and company records — through one clean REST API, or natively inside Claude Code and Codex via MCP. Connect once, then query in plain language. Every plan is flat and unlimited, so responses always return credits_used: 0.

BASEhttps://app.saleshub.ai/v1

Quickstart

The fastest path is the hosted MCP server — no install, no Python. Two steps and your agent has a data department.

  1. Connect once. Run claude mcp add -s user --transport http saleshub https://app.saleshub.ai/mcp --header "Authorization: Bearer sh_live_…" in Claude Code, or add the same url + header to your Codex config. Your key as a bearer token meters your own usage.
  2. Just ask. Speak in plain language; the agent picks the right tools and returns clean rows.

Full walkthrough for Claude Code, Claude Desktop, Codex, Cursor & Windsurf → Install & MCP setup.

Prefer raw HTTP? Every tool is also a REST endpoint. Here's the same company search as a direct call:

bash
$ curl -X POST https://app.saleshub.ai/v1/search/companies \
  -H "Authorization: Bearer $SALESHUB_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Stripe", "limit": 5 }'

Authentication

Saleshub uses bearer tokens. Pass your key in the Authorization header on every request. Keys are scoped per project, follow the format sh_live_…, and rotate from the console — no key ever appears in a response body.

header
Authorization: Bearer sh_live_8fA2c…9pQ
!

Keep keys server-side. Treat sh_live_ keys like passwords. For browser or agent contexts, mint a scoped key from the console rather than embedding your primary key.

Plans & rate limits

There are no per-row or per-credit charges. Pick a tier by seats and signals, not by rows — enrichment, search, and verification are unlimited on every plan. Rate limits are generous and tiered; a 429 always includes a Retry-After header.

PlanRate limitPer-row costSeats
Starter60 req/min$01
Growth1,000 req/min$05
Agency5,000 req/min$0Unlimited

Errors

Saleshub uses conventional HTTP status codes. Bodies carry an error label and a human-readable message.

200Success.
401Unauthorized — invalid or missing API key.
422Invalid input — a parameter failed validation.
429Too many requests — retry after the header window.

Next steps