LeadMarmot · API
Docs

LeadMarmot API

The daily file as JSON: the companies that just raised or launched, what each needs most, the opener, and the contact paths. The API returns the same rows a member receives by email, nothing less.

Quick start

No key needed for the sample: ten real leads from a recent file.

curl "https://leadmarmot.com/api/v1/leads?sample=1"

With your key, the latest file:

curl -H "Authorization: Bearer YOUR_KEY" "https://leadmarmot.com/api/v1/leads"

Your key

Every member has one key, and it works from the first minute of the 7-day trial. You find it in three places: on the welcome page right after you sign up, on your list page under "Your agent and the API", and in every LeadMarmot email.

Send it as a header, Authorization: Bearer YOUR_KEY, or as ?key=YOUR_KEY where a tool cannot set headers.

Requests

One endpoint, GET /api/v1/leads, and a few parameters.

ParameterWhat it returns
(none)The latest file.
date=YYYY-MM-DDThe file of one day.
since=YYYY-MM-DDEvery lead since that day, newest first.
need=GEOOnly leads with this need: GEO, SEO, content, paid/CRO, PR/social, technical.
company=acme.comOne company, by website or name: its most recent record.
limit, offset50 rows by default, 500 at most. Page with offset.
sample=1Ten sample leads. No key.
stats=1How many leads the last seven days hold. No key.
GET /api/v1/leads?since=2026-11-01&need=GEO&limit=200
GET /api/v1/leads?date=2026-11-06
GET /api/v1/leads?company=yk-robotics.com

Response

A day returns { "date", "leads": [...] }. A range returns { "since", "to", "count", "leads": [...] }. One lead, shortened:

{
  "signal_date": "2026-10-29",
  "company": "YK-Robotics",
  "website": "yk-robotics.com",
  "signal": "raised $1.1M Seed",
  "round": "Seed",
  "amount": "$1.1M",
  "needs": "GEO, paid/CRO, SEO, PR/social",
  "top_need": "GEO",
  "hook": "YK-Robotics raised $1.1M Seed on 2026-10-29. When their buyer asks ChatGPT \"What software helps system integrators program robotic cells across multiple robot brands?\", it answers RoboDK, not YK-Robotics.",
  "contact_email": "info@yk-robotics.com",
  "email_type": "role",
  "email_verified": "role_account",
  "linkedin": "https://www.linkedin.com/company/yk-robotics",
  "contact_form": "https://www.yk-robotics.com/contacts",
  "buyer_question": "What software helps system integrators program robotic cells across multiple robot brands?",
  "chatgpt_recommends_them": "no",
  "rival_chatgpt_names": "RoboDK",
  "analytics": "no",
  "customer_proof": "no",
  "what_they_sell": "AI-powered robotic cell software for system integrators and manufacturers."
}

Fields

FieldMeaning
signal_dateThe day the company raised or launched.
company, websiteWho it is.
signalWhat happened, in words: "raised $1.1M Seed", "launched".
round, amountThe round and its size, when it is a raise.
country, sector, what_they_sellWhere, in which field, and the product in one sentence.
hiring, pricing"yes" when the site has a careers page or a pricing page.
needs, top_needWhat the company needs, strongest first: GEO, SEO, content, paid/CRO, PR/social, technical.
hookThe opening line: the fact about their own business that makes the need plain.
contact_emailThe company's shared mailbox (info@, hello@), when its site shows one. Never a named person's address.
email_type"role" when contact_email is filled. "named" when the site shows a named person's address instead: the file leaves it out, and the person is one click away on the company's site.
email_verifiedThe verifier's verdict: safe, role_account, catch_all, or empty when unchecked.
linkedin, contact_form, x_handleThe other ways in.
buyer_questionThe question their buyer asks an AI assistant.
chatgpt_recommends_themWhether ChatGPT names them for that question.
rival_chatgpt_namesWho it names instead.
pages_chatgpt_readsThe pages its answer was built from.
claude_recommends, gemini_recommendsThe same verdict from the other two assistants, when checked.
google_own_name_rankWhere their own site ranks for their own name.
analyticsWhether the site carries an analytics tag or an ad pixel.
content_engine, site_pagesWhether they publish, and how many pages the site has.
customer_proofWhether the site shows customers, logos or testimonials.
ai_crawlers_blocked, meta_and_ogTechnical checks: AI crawlers blocked in robots.txt, title and share tags present.

Limits

The API serves the last 30 days. A new file lands every morning. Each key can make 60 requests a minute; every response says where you stand in X-RateLimit-Limit and X-RateLimit-Remaining.

Errors

Errors are JSON: { "error": "...", "docs": "https://leadmarmot.com/docs" }.

StatusWhen
400A date that is not YYYY-MM-DD, or older than the last 30 days.
401No key, a wrong key, or a membership that has ended.
429More than 60 requests in a minute. Retry-After says when to come back.

MCP server

The same data as tools an agent can call. Add this URL as an MCP server in Claude, ChatGPT or Cursor:

https://leadmarmot.com/mcp?key=YOUR_KEY

It speaks JSON-RPC over POST (Streamable HTTP) and also accepts the key as a Bearer header. Three tools:

ToolWhat it does
sample_leadsTen sample leads. No key.
leadsThe leads of one day, with optional date, need and limit.
leadOne company's full record, by name or website.

Guides

Step by step for lemlist, Instantly, Smartlead, Clay, Zapier, Make and HubSpot: all guides.

Compare

How LeadMarmot compares with Clay, Dealroom, Harmonic, Growth List, Fundz, doing it yourself and others.

Get a key. The 7-day trial opens the API, the MCP server and the daily file at once. Cancel any time.

Start the 7-day trial