Address Finder
Find an address
Start an Address Finder lookup for a person's business mailing address.
Address Finder finds a person's business mailing address from their LinkedIn profile, or from their company and location. Use it when you know who to write to, but not where to send the letter.
POST https://platform.scribeless.co/api/address-finder/lookups
Address Finder is available on request. Contact the Scribeless team to turn it on for your team.
A lookup runs in the background and usually takes 30 to 90 seconds. This endpoint starts the lookup and returns its ID. Then call GET /api/address-finder/lookups/{lookupId} until status is completed or failed.
Headers
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Body
Send one of these input sets:
linkedin_url.company_domainoremail, withlocation,address.cityoraddress.postal_code.- A full street address (
address.address1,address.cityand a country), withfull_nameorcompany_name.
Add other fields when you have them. More inputs give better results.
| Field | Type | Description |
|---|---|---|
linkedin_url | string | LinkedIn profile URL of the person. Maximum length is 500 characters. |
full_name | string | Full name of the person. |
job_title | string | Job title of the person. |
email | string | Work email of the person. |
company_domain | string | Company website domain, for example acme.com. |
company_name | string | Company name. |
location | string | Free-text location, for example London or Austin, TX. |
country | string | Two-letter country code, for example GB or US. UK is accepted as GB. |
address | object | A known address to check. Fields: address1, address2, address3, city, state, postal_code, country. |
external_id | string | Your own reference for the lookup, for example a CRM contact ID. Maximum length is 160 characters. |
Text fields have a maximum length of 200 characters. Unknown fields are rejected.
Example request
curl --request POST 'https://platform.scribeless.co/api/address-finder/lookups' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"linkedin_url": "https://www.linkedin.com/in/jane-doe",
"company_domain": "acme.com",
"external_id": "crm-contact-123"
}'
Response
Successful requests return 202 with the lookup ID.
{
"id": "LOOKUP_ID",
"status": "queued"
}
Lookups and your limit
- Each new lookup uses one lookup from your team's limit, also when no address is found.
- The limit is a total. It does not reset each month. Contact the Scribeless team to add more lookups.
- The same inputs for the same team return the first lookup again and do not use another lookup.
external_idis not part of this check. - Check how many lookups you have left with
GET /api/address-finder/usage.
Status codes
| Status | Meaning |
|---|---|
202 | Lookup started. |
400 | Invalid body, or not enough inputs to search. |
401 | Missing, malformed, invalid, or unauthorized API key. |
403 | Address Finder is not enabled for your team. |
429 | Your team has used all its lookups. |
502 | Address Finder is temporarily unavailable. Retry later. |