August 2023: New Reverse Contact Number Lookup API & More from Proxycurl
LinkDB pricing is live, plus new and exciting products!

/ changelog

August 2023: New Reverse Contact Number Lookup API & More!

Steven Goh
Share:

Subscribe to our newsletter

Get the latest news from Proxycurl

Proxycurl's August 2023 updates are here! Featuring a new endpoint, improvements to existing endpoints, and LinkDB public pricing! Plus a brand-new product launch in case you haven't already seen it!

LinkDB pricing is now public

We've revealed our LinkDB pricing to the public - no need to contact a sales representative for a blind quote, you can come in knowing what to expect. See our LinkDB pricing page for all the details.

New Reverse Contact Number Lookup Endpoint

Have a phone number you want to resolve? We now have a Reverse Contact Number Lookup Endpoint.

A typical request might look like this:

import json, os, requests
api_key = os.environ['PROXYCURL_API_KEY']
headers = {'Authorization': 'Bearer ' + api_key}

api_endpoint = 'https://nubela.co/proxycurl/api/resolve/phone'
params = {
    'phone_number': '+14155552671',
}
response = requests.get(api_endpoint, params=params, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Note that the phone number in this example is from the United States, thus the +1 country code. The area code is 415, and the full telephone number is (415) 555-2671 expressed in the E.164 standard. (In this case, this is a fake phone number used as an example.)

A response might look like this (example data displayed):

{
  "facebook_profile_url": "https://www.facebook.com/zuck",
  "linkedin_profile_url": "https://www.linkedin.com/in/senatormarty",
  "twitter_profile_url": "https://www.twitter.com/proxycurl"
}

The endpoint costs 3 credits to use, but if no results are found, you won't be charged.

Avoid null result charges in the Person Lookup Endpoint

We've added a parameter called similarity_checks to the Person Lookup Endpoint. It has two values:

  • include (default) - If you don't get a good match, try harder to find a close match. You WILL be charged for null results in this case because of the extra effort.
  • skip - If you don't get a good match, return null immediately. You will NOT be charged for null results in this case.

Here's an example comparing the outputs:

import json, os, requests
api_key = os.environ['PROXYCURL_API_KEY']
headers = {
    'Authorization': 'Bearer ' + api_key,
}
endpoint = 'https://nubela.co/proxycurl/api/linkedin/profile/resolve'
params = {
    # 'location': 'Seattle',
    "company_domain": "twitter.com",
    "first_name": "jennyy", # Deliberately misspelled
    "title": "security",
    "similarity_checks": "skip"
}

response = requests.get(endpoint, params=params, headers=headers)
result = response.json()
print('Skip: ' + json.dumps(result))
params['similarity_checks'] = 'include'

response = requests.get(endpoint, params=params, headers=headers)
result = response.json()
print('Include: ' + json.dumps(result))

Note: Once the lookup has been run with include as the value of similarity_checks, the result will be cached for future lookups; thus, if you want to test the behavior, please make the request with skip first.

See the number of Search results without loading them all

You can now see how many results were in your query without fetching every single page!

Here is a code sample demonstrating:

import os, requests
api_key = os.environ['PROXYCURL_API_KEY']
headers = {'Authorization': 'Bearer ' + api_key}

person_endpoint = 'https://nubela.co/proxycurl/api/search/person'
params = {
    'current_company_name': '^(?!(^Stealth$)|(.*Stealth.*Startup.*))',
}
response = requests.get(person_endpoint, params=params, headers=headers)
result = response.json()
print(result['total_result_count'])

This sample uses the Person Search Endpoint; the parameter also exists on results from the Company Search Endpoint. Search now to check it out!

Use Proxycurl APIs inside Google Sheets!

Prefer to use spreadsheets instead of writing code? Or do you have stakeholders who prefer to get answers for themselves rather than filing tickets? Sapiengraph could be the perfect fit for your team.

Enrich B2B data within Google Sheets with Sapiengraph

Get Proxycurl's data within Google Sheets, wrapped in easy-to-use formulas with syntax like:

  • =SG_COMPANY("https://www.linkedin.com/company/stripe/","description")
  • =SG_COMPANY_LOCATIONS("https://www.linkedin.com/company/stripe/","city")
  • =SG_PERSON("https://www.linkedin.com/in/johnrmarty", "first_name")

Check out our launch announcement to learn more, or jump straight to Sapiengraph's complete formula documentation.

Contact us to get started now

Interested in purchasing LinkDB or in learning more about Sapiengraph or our other endpoints? Email us at [email protected], and we'll help you get started!

Subscribe to our newsletter

Get the latest news from Proxycurl

Steven Goh
Share:

Featured Articles

Here’s what we’ve been up to recently.