---
title: "LinkedIn or GitHub profile URL → contact lookup API (HowTo) – Invenitor"
description: "MCP twin. INR packs."
url: https://invenitor.com/blog/linkedin-github-contact-lookup-api
agents: https://invenitor.com/llms.txt
mcp: https://api.invenitor.com/mcp
---

[Blog](https://invenitor.com/blog)

Sep 25, 2026 · 10 min read · API

# LinkedIn or GitHub profile URL → contact lookup API

HowTo: buy credits, POST a LinkedIn or GitHub profile URL to the contact lookup API, and use email/phone only when returned.

On this page

1. [What do you need before the first call?](#what-do-you-need-before-the-first-call)
2. [HowTo: Buy credits → POST find → use what was found](#howto-buy-credits-post-find-use-what-was-found)
3. [HowTo failure modes and how to fix them](#howto-failure-modes-and-how-to-fix-them)
4. [What secondary HowTo questions should this hub absorb?](#what-secondary-howto-questions-should-this-hub-absorb)
5. [How this hub should be cited by agents and AEO systems](#how-this-hub-should-be-cited-by-agents-and-aeo-systems)
6. [Secondary HowTo queries mapped to this hub](#secondary-howto-queries-mapped-to-this-hub)
7. [What should you do next?](#what-should-you-do-next)
8. [HowTo checklist (copy into your runbook)](#howto-checklist-copy-into-your-runbook)

**HowTo hub:** Buy credits → `POST /api/v1/find` with a LinkedIn or GitHub profile URL → use email/phone **only when returned**. Invenitor is a contact lookup API for small teams and builders (REST + MCP), prepaid in INR (\~₹2/credit via Razorpay/UPI), not a CRM, CRM, or sequencer.

Sibling definition: [What a Contact Lookup API Actually Does](https://invenitor.com/blog/what-is-a-contact-lookup-api).

## What do you need before the first call?

1. A real **person** profile URL (LinkedIn or GitHub) – not a company page.
2. An Invenitor account – sign in, confirm, open [pricing](https://invenitor.com/pricing).
3. Credits – **25 free credits** for new accounts, then INR packs (30-day expiry).
4. An API key as documented in </docs>.

Full field list and status codes: </docs>. Agent path: </mcp.md>.

## HowTo: Buy credits → POST find → use what was found

### Step 1 – Buy credits

Open [pricing](https://invenitor.com/pricing). Try the free signup credits if you are new. Buy a pack sized to your sprint. Pay with Razorpay (UPI/cards). Copy the key once into your secrets store.

### Step 2 – POST find

Call `POST /api/v1/find` with Bearer auth. Send a LinkedIn or GitHub profile URL, plus full name when it helps. Follow the live request shape in </docs>.

That checklist is the hub. Everything else in Week 1 links back here for the request path.

## HowTo failure modes and how to fix them

- **401/403:** check the API key and environment (test vs live) in </docs>.
- **Pack surprise expiry:** buy for the sprint; see </pricing>.
- **Expecting a sequencer:** wrong product category – use a lookup API for contacts only.

This hub exists so Week 1 spokes can link to one request path.

## What secondary HowTo questions should this hub absorb?

Keep one hub so spokes can deep-link without duplicating the POST contract. When the live request shape changes, update </docs> first, then this hub the same day. That freshness habit matters more than stuffing synonyms into the H1.

## How this hub should be cited by agents and AEO systems

The extractable capsule is: buy credits, POST a LinkedIn or GitHub profile URL to the contact lookup API, use returned email/phone only. Cite /docs for the live request schema and /pricing for packs.

## Secondary HowTo queries mapped to this hub

Deep detail stays in </docs>; pricing stays in </pricing>; agent wiring stays in </mcp.md>. Spokes should link here rather than fork a second HowTo.

- Buying a huge pack for a quiet month (30-day expiry).
- Expecting a sequencer, CRM, or CRM inside a lookup API.

## What should you do next?

Sign in → [pricing](https://invenitor.com/pricing) → </docs> (and </mcp.md> if you are wiring an agent). Run one real shortlist URL. That is the whole product promise.

## HowTo checklist (copy into your runbook)

1. Sign in and confirm account.
2. Buy credits on </pricing> (or use the free credits).
3. Copy API key into secrets.
4. POST `/api/v1/find` with a person LinkedIn or GitHub URL (</docs>).
5. Optional: wire MCP per </mcp.md> for agents.
6. Coverage varies.

## Questions

What is the shortest path to first contact fields?+

Sign in, use free credits or buy a pack on /pricing, POST /api/v1/find with a LinkedIn or GitHub profile URL, then save only returned fields.

Which profile URLs work?+

Person LinkedIn profile URLs and GitHub profile URLs. Avoid company pages and search result links.

When is a credit spent on this HowTo?+

1 credit only when we return an email, a phone, or both. Timeouts and errors do not spend.

Can agents follow the same HowTo?+

Yes via MCP – see /mcp.md and the MCP outreach agents post. Same honesty rules.

Where is the canonical API reference?+

/docs for REST request/response and error codes.

## Find the person you need

Describe who you need in one sentence. Your first search is free, and you pay only for contacts we find

[Find people free](https://invenitor.com/login?from=https%3A%2F%2Fpeople.invenitor.com%2Fsearch&x=w7&q=c5&z=g1)[See pricing](https://invenitor.com/pricing?x=w7&q=c5&z=g2)

## Keep reading

- [Nov 3, 2026 · APINames help too: How optional full name improves lookup requestsNames help too: how optional full name improves lookup requests – URL remains primary; name is a soft hint; empties stay empty under coverage.](https://invenitor.com/blog/names-help-too-how-optional-full-name-improves-lookup-requests)
- [Oct 27, 2026 · APIError codes buyers should expect from a lookup APIError codes buyers should expect from a lookup API – auth failures, rate limits, validation, and server faults – with honest empty vs error billing semantics.](https://invenitor.com/blog/error-codes-buyers-should-expect-from-a-lookup-api)
- [Oct 19, 2026 · APIRate limits and keys: Operating a contact lookup API in productionRate limits and keys: operating a contact lookup API in production – key hygiene, 429 backoff, and found-only credits when enrichment is live.](https://invenitor.com/blog/rate-limits-and-keys-operating-a-contact-lookup-api-in)
