Forager API quickstart

In about 5 minutes you’ll look up the phone numbers for one person from their LinkedIn public identifier, the part of a profile URL after /in/.

Using a coding agent? Paste this instead and it will do the steps for you:

Setup prompt

Read https://www.forager.ai/docs/guides/agent-quickstart.md and follow it to add the Forager API to this project. Keep my API key server-side in FORAGER_API_KEY and FORAGER_ACCOUNT_ID.

Get your API key and Account ID

Create a free account at app.forager.ai. Then:

Create a key on the API page.
Copy your Account ID from My Account.

Set both in your terminal:

export FORAGER_API_KEY="your-api-key"
export FORAGER_ACCOUNT_ID="your-account-id"

Keep the key server-side. Don’t commit it or put it in browser code. See authentication.

Look up phone numbers

Send a POST to the phone number lookup with a LinkedIn public identifier. You can send a Forager person_id instead.

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/person_contacts_lookup/phone_numbers/" \
  -H "X-API-KEY: $FORAGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_public_identifier": "billgates"}'

import os, requests

resp = requests.post(
    f"https://api-v2.forager.ai/api/{os.environ['FORAGER_ACCOUNT_ID']}/datastorage/person_contacts_lookup/phone_numbers/",
    headers={"X-API-KEY": os.environ["FORAGER_API_KEY"]},
    json={"linkedin_public_identifier": "billgates"},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch(
  `https://api-v2.forager.ai/api/${process.env.FORAGER_ACCOUNT_ID}/datastorage/person_contacts_lookup/phone_numbers/`,
  {
    method: "POST",
    headers: { "X-API-KEY": process.env.FORAGER_API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ linkedin_public_identifier: "billgates" }),
  },
);
if (!resp.ok) throw new Error(`Forager returned ${resp.status}`);
console.log(await resp.json());

Each phone number lookup uses 15 credits. See credits and pricing.

Read the response

The response is a list of phone numbers. Each item has a phone_number field.

Example response (illustrative values)

[
  { "phone_number": "+12025550142" },
  { "phone_number": "+12025550187" }
]

If the key is missing or wrong, you get a 403:

Status	Message	What to do
`403`	`Authentication credentials were not provided.`	Check the `X-API-KEY` header and the key value.
`403`	`Forbidden`	The key can’t access this resource. Check the Account ID in the path.

See API errors and rate limits for the errors documented so far and their response bodies.

Go deeper in your language

The cURL, Python and Node.js quickstarts repeat these steps with a small client that handles 403 and 429, then submit and poll an asynchronous work email lookup.

Build your next request

Pick an endpoint and fill in the parameters to get the matching cURL, Python or JavaScript. The samples read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from your environment; nothing is sent from this page.

Next steps

Choose the right endpoint

Match what you have to what you need, with the cost of each call.

Recipes

End-to-end builds for dialers, CRMs, recruiting and data teams.

Try it in the API reference

Send the same request from your browser.

Postman collection

Every operation, ready to import. Set the apiKey and accountId variables.

Get started

Contact data

People and companies

Account and billing

Production

Help

Coming soon

Go deeper in your language

Build your next request

Next steps

Choose the right endpoint

Recipes

Try it in the API reference

Postman collection

​Go deeper in your language

​Build your next request

​Next steps

Choose the right endpoint

Recipes

Try it in the API reference

Postman collection

Go deeper in your language

Build your next request

Next steps