FounderMCPDocs

API

The FounderMCP API

Search LinkedIn for people and enrich their profiles from your own code, over one REST API.

View Markdown

The FounderMCP API gives your own code the people data behind FounderMCP: find people by title, company, location and seniority, then fetch their full profile — and, if you want, a work email. Every call is metered in credits; you only pay for results.

What you can do

  • Search People — filter LinkedIn by current title, company, location, seniority, department, company size and more. One page of up to about 25 people per call.
  • Enrich People — the full profile of up to 25 people per call: positions, education, skills, languages, certifications. Optionally with an email address.
  • Get Usage — the credits you used today and this month. Free.

Live data, not a snapshot

Every call fetches the data live from LinkedIn at the moment you ask. There is no stale copy in between: a job change from this morning is in the answer. The flip side is speed — a search takes seconds, and an enrich of 25 profiles can take half a minute. Set generous HTTP timeouts and run long batches in the background.

What lives where

  • API Access in FounderMCP (the API item in the navigation) — your keys, your usage and the pricing.
  • This documentation — concepts: authentication, credits and limits.
  • API reference — every endpoint with its parameters, responses and examples.

First call

Create a key under API → API Keys, then check that it works. This call is free:

curl "https://geteem.com/api/v1/usage" \
  -H "Authorization: Bearer $SIMBA_API_KEY"

A search, then an enrich of the first result:

curl -X POST "https://geteem.com/api/v1/person/search" \
  -H "Authorization: Bearer $SIMBA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "current_job_titles": ["CFO"], "locations": ["Belgium"], "recently_changed_jobs": true }'

curl -X POST "https://geteem.com/api/v1/person/enrich" \
  -H "Authorization: Bearer $SIMBA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_urls": ["<linkedin_url from the search>"], "include_email": true }'

Next steps