Scribeless
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_domain or email, with location, address.city or address.postal_code.
  • A full street address (address.address1, address.city and a country), with full_name or company_name.

Add other fields when you have them. More inputs give better results.

FieldTypeDescription
linkedin_urlstringLinkedIn profile URL of the person. Maximum length is 500 characters.
full_namestringFull name of the person.
job_titlestringJob title of the person.
emailstringWork email of the person.
company_domainstringCompany website domain, for example acme.com.
company_namestringCompany name.
locationstringFree-text location, for example London or Austin, TX.
countrystringTwo-letter country code, for example GB or US. UK is accepted as GB.
addressobjectA known address to check. Fields: address1, address2, address3, city, state, postal_code, country.
external_idstringYour 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_id is not part of this check.
  • Check how many lookups you have left with GET /api/address-finder/usage.

Status codes

StatusMeaning
202Lookup started.
400Invalid body, or not enough inputs to search.
401Missing, malformed, invalid, or unauthorized API key.
403Address Finder is not enabled for your team.
429Your team has used all its lookups.
502Address Finder is temporarily unavailable. Retry later.
Copyright © 2026