API Introduction

Use this page to send your first request and to understand the conventions shared by all endpoints. For a walkthrough, start with The FounderMCP API.

Base URL

All requests go to:

https://geteem.com/api/v1

Authentication

Every request must include your API key as a Bearer token in the Authorization header:

--header 'Authorization: Bearer YOUR_API_KEY'

Create keys under API → API Keys in FounderMCP. Keep them secret: never put a key in client-side code or a public repository. See Authentication.

Request format

Send a JSON body with Content-Type: application/json. Field names are snake_case. Unknown fields are rejected with 400 rather than ignored, so a typo never silently drops a filter.

Response format

Every response is JSON. Paid endpoints add credits_used to the body and an X-Credits-Used header with the same number.

Error responses

Every error has the same shape. Branch on error.type; the message is meant for people and can change.

{
  "error": {
    "type": "invalid_request",
    "message": "`page` must be a whole number from 1 to 100."
  }
}

Errors never cost credits.

HTTP status codes

• 400 invalid_request — The body is not valid JSON, a field is unknown or has the wrong type, or a value is not allowed.
• 401 authentication_error — The Authorization header is missing, or the key is unknown or revoked.
• 403 permission_error — API access is not part of your plan, or your account is suspended.
• 404 not_found — The endpoint does not exist.
• 429 rate_limit_error — More than 60 requests per minute, or more than 3 at the same time, on one key. Wait for the Retry-After header.
• 429 daily_limit_reached — The request could take your organization over its daily credit limit. The limit resets at midnight (Europe/Brussels).
• 402 insufficient_credits — The credit balance is lower than this request could cost. Nothing was charged. Add credits, or send a smaller request. The error includes code, fix and a link to the credits docs.
• 502 upstream_error — The data source did not answer. Retry later.
• 503 service_unavailable — The API is temporarily unavailable. Retry later.
• 500 internal_error — Something went wrong on our side.

Rate limits

• 60 requests per minute and 3 concurrent requests per key.
• A daily credit limit per organization — 1,000 credits unless agreed otherwise — that resets at midnight Europe/Brussels.

Both answer with 429 and a Retry-After header. More in Credits and limits.

Endpoints

• Search People — POST /person/search — Find people on LinkedIn by title, company, location, seniority and more.
• Enrich People — POST /person/enrich — Get the full LinkedIn profile of up to 25 people, optionally with a work email.
• Get Usage — GET /usage — Credits used today and this month, and your daily limit.