POST /find_linkedin_url_by_email • Credits: 4 credits per call

The RichAPI Find LinkedIn URL by Email API turns one email address into one LinkedIn profile URL. Send a POST request to /find_linkedin_url_by_email with the field email, and the response returns the LinkedIn profile URL of that person. One call costs 4 credits, which is $0.08.

What Find LinkedIn URL by Email does

Find LinkedIn URL by Email runs a reverse lookup. The input is one work email address or one personal email address. The output is the LinkedIn profile URL that belongs to the owner of that address. A CRM record, a webform signup and a newsletter list often hold an email address and nothing else. That record has no LinkedIn URL, so no profile enrichment can run against it. Find LinkedIn URL by Email supplies the missing URL. The endpoint is synchronous, so the result arrives in the same HTTP call.

Where do I send a Find LinkedIn URL by Email request?

Method: POST
URL: https://api.richapi.ai/api/v1/find_linkedin_url_by_email
Authentication: x-api-key header
Content type: application/json
Response: synchronous JSON
Cost: 4 credits per call

How to send a Find LinkedIn URL by Email request

Copy the API key from the RichAPI dashboard.
Set the x-api-key header to that API key.
Set the Content-Type header to application/json.
Put one email address in the email field of the request body.
Send the request to https://api.richapi.ai/api/v1/find_linkedin_url_by_email.
Read the LinkedIn profile URL from data in the response.

CAUTION: Write the field name email in lower case. A request body with the key Email returns 400 and the error Unknown input field(s): Email.

cURL

curl -X POST https://api.richapi.ai/api/v1/find_linkedin_url_by_email   
  -H "x-api-key: YOUR_API_KEY"   
  -H "Content-Type: application/json"   
  -d '{
    "email": "[email protected]"
  }'

Python

import requests

response = requests.post(
    "https://api.richapi.ai/api/v1/find_linkedin_url_by_email",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"email": "[email protected]"},
    timeout=60,
)
response.raise_for_status()

result = response.json()
print(result["data"]["LinkedIn Profile URL"])

Node.js

const response = await fetch(
  "https://api.richapi.ai/api/v1/find_linkedin_url_by_email",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      email: "[email protected]",
    }),
  },
);

const result = await response.json();
console.log(result.data["LinkedIn Profile URL"]);

What parameters does Find LinkedIn URL by Email accept?

Parameter	Type	Required	Default	Description
`email`	string	Yes	`""`	The email address of one person. Example: `[email protected]`

Find LinkedIn URL by Email accepts no other field. Any other key in the request body returns 400 with an Unknown input field(s) error. The endpoint accepts no path parameter and no query parameter.

What does Find LinkedIn URL by Email return?

Find LinkedIn URL by Email returns one JSON object. The data object holds the single key LinkedIn Profile URL, and status holds the status of the request. RichAPI also adds a richapi_meta object to every response, with the request ID and the credits charged.

The following block is an example response. The field names are exact. The values illustrate the shape and the type of each field.

{
  "data": {
    "LinkedIn Profile URL": "https://www.linkedin.com/in/satyanadella"
  },
  "status": "success"
}

What does each Find LinkedIn URL by Email response field mean?

Field	Type	Description
`data`	object	The result container. It holds the key `LinkedIn Profile URL`.
`data["LinkedIn Profile URL"]`	string	The LinkedIn profile URL of the owner of the email address.
`status`	string	The status of the request.

The key LinkedIn Profile URL holds a space in each word boundary. Read it with bracket notation, for example result["data"]["LinkedIn Profile URL"] in Python.

How to pass the LinkedIn URL to Profile Enrichment

The LinkedIn profile URL is the input format of the Profile Enrichment API. Chain the two calls to turn one email address into a full person record.

Send the email address to /find_linkedin_url_by_email.
Read data["LinkedIn Profile URL"] from the response.
Send that URL in the url field to /enrich_profile.
Read the name, the job title, the employer and the work history from the second response.

import requests

HEADERS = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}

lookup = requests.post(
    "https://api.richapi.ai/api/v1/find_linkedin_url_by_email",
    headers=HEADERS,
    json={"email": "[email protected]"},
    timeout=60,
)
lookup.raise_for_status()
linkedin_url = lookup.json().get("data", {}).get("LinkedIn Profile URL")

if linkedin_url:
    profile = requests.post(
        "https://api.richapi.ai/api/v1/enrich_profile",
        headers=HEADERS,
        json={"url": linkedin_url},
        timeout=60,
    )
    profile.raise_for_status()
    print(profile.json())

The chain costs 5 credits per person, which is $0.10. Find LinkedIn URL by Email costs 4 credits and Profile Enrichment costs 1 credit.

How much does Find LinkedIn URL by Email cost?

Find LinkedIn URL by Email costs 4 credits per call. One credit costs $0.02 on the 1,000 and 5,000 credit packs, so one call costs $0.08 there. Larger packs cost less per credit. The cost of 500 calls is 2,000 credits, and 2,000 credits cost $40.00.

Calls	Credits	Cost
1	4	$0.08
100	400	$8.00
500	2,000	$40.00
1,000	4,000	$80.00
10,000	40,000	$800.00

RichAPI reserves 4 credits before the provider call. RichAPI commits the reservation for a 2xx response and refunds the reservation for every other status.

Does a result that is not found still cost 4 credits?

Find LinkedIn URL by Email is not a waterfall endpoint. The waterfall rule that makes a miss free does not apply here. Billing follows the HTTP status of the response alone.

Outcome	HTTP status	Credits charged
The provider returns a LinkedIn profile URL.	`200`	4
The provider returns `200` with an empty result.	`200`	4
The provider returns an error status, for example `404`.	The provider status	0
The request body fails validation.	`400`	0
The organization has too few credits, or the team hit its monthly spend limit.	`402`	0
RichAPI or the provider fails.	`500`, `502`, `504`	0

A 2xx response always costs 4 credits. A 2xx response with an empty result costs the same 4 credits. To avoid a charge for a record that cannot match, filter the email list before the call. Remove every role address, for example info@ and support@, and remove every address on a free mail domain.

What errors can Find LinkedIn URL by Email return?

Status	Meaning	What to do
`200`	The lookup ran and the result is in the response.	Read `data["LinkedIn Profile URL"]`.
`400`	The request body failed validation.	Correct the field that the error message names. The `supported_fields` key in the response lists every valid input.
`401`	The API key is missing, wrong or revoked.	Send a valid key in the `x-api-key` header.
`402`	`Insufficient credits`: the organization has too few credits for the call. Or `Monthly spend limit reached`: the team hit its monthly spend limit.	Buy credits in the RichAPI dashboard, or ask the organization owner to raise the spend limit.
`403`	`Endpoint not available on your plan`: this API key has no access to this endpoint.	Call `GET /api/v1/my-endpoints` to list the endpoints this key can use. Contact support for access.
`404`	The provider found no record for the email address.	Check the email address. Try the Find LinkedIn URL by Name API instead.
`405`	The request used a method other than `POST`.	Send the request as `POST`.
`429`	Too many requests.	Wait, then send the request again. The `Retry-After` header names the wait in seconds.
`500`	The API failed.	Send the request again. If the failure repeats, contact support.
`502`	The upstream provider failed.	Send the request again after a short wait.
`504`	The upstream provider timed out.	Send the request again after a short wait.

Every error response holds an error field with a plain-language message:

{
  "error": "Unknown input field(s): Email",
  "supported_fields": {
    "accepted": ["email"],
    "required": ["email"]
  }
}

Frequently asked questions

Does Find LinkedIn URL by Email find a LinkedIn profile for every email address?

No. Find LinkedIn URL by Email matches the email address against a provider data set. If that data set holds no record for the address, the response carries no LinkedIn profile URL. A role address, a personal address on a free mail domain and a recently created address are the three inputs that match least often.

What is the correct field name in a Find LinkedIn URL by Email request body?

The field name is email, in lower case. A request body with Email returns 400 and the error Unknown input field(s): Email.

Does a Find LinkedIn URL by Email call that finds nothing cost credits?

A 2xx response costs 4 credits, and a 2xx response with no LinkedIn profile URL costs the same 4 credits. RichAPI bills on the HTTP status, because Find LinkedIn URL by Email is not a waterfall endpoint. Every 4xx response and every 5xx response costs 0 credits, because RichAPI refunds the credit reservation.

What do I do with the LinkedIn URL that Find LinkedIn URL by Email returns?

Send the URL to the Profile Enrichment API in the url field. Profile Enrichment returns the name, the headline, the location, the work history and the skills. That chain costs 5 credits per person in total.

Can Find LinkedIn URL by Email process a list of email addresses in one request?

No. Find LinkedIn URL by Email accepts one email value per request and returns one result. For a list, send one request per address and control the rate of the calls. A 429 response means that the rate is too high.

What is the difference between Find LinkedIn URL by Email and Find LinkedIn URL by Name?

Find LinkedIn URL by Email takes one email address as the input. Find LinkedIn URL by Name takes a full name and a company name as the input. Both endpoints return a LinkedIn profile URL. Find LinkedIn URL by Email costs 4 credits per call. Find LinkedIn URL by Name costs 0.2 credits for a call that finds a profile, and nothing for a call that finds none. If the record holds no email address, use Find LinkedIn URL by Name.

Can I call Find LinkedIn URL by Email from n8n or an MCP client?

Yes. Find LinkedIn URL by Email is available in both integrations. The n8n operation name is find_linkedin_url_by_email. The MCP tool name is find_linkedin_url_by_email.