https://api.datafinder.com/v2/qdf.php?k2={your-key}&service=social
Use the config parameters to adjust elements like the output language.
Name | Description | Required? |
---|---|---|
k2 | Your api key | Yes |
service | Which API service to use. Use "social" in this case. | Yes |
output |
Specify json or xml output responses. Default is JSON. Example: output=json |
Any parameter that begins with a "d_" is a search parameter. We will use these parameters to try and match an individual or household. Some search parameters will not return results if used by themselves, such as d_last or d_first. If a search parameter requires another, it will be noted in the table below.
NOTE: d_first and d_last are required for an individual level match.
Name | Description |
---|---|
d_email |
Valid email address Example: d_email=account_name@domain.com |
Api results will follow the schema shown below and will include:
Name | Description | What is returned |
---|---|---|
FirstName | First name | First name |
LastName | Last name | Last name |
EmailAddr | Email address | Email address |
FBName | The name of the Facebook user | Usually a first and last name |
FBUID | The Facebook ID for a user | An integer, typically like 1446039785 |
FBURL | The Facebook URL for viewing a profile | https://facebook.com/some.name |
Output schema in JSON:
{ "datafinder": { "version": "2.0", "query-id": "xxxxxx", "results": [ { "key": "value" } ], "input-query": { "key": "value" }, "num-results": 1, "query-time": "0.000", "page-time": "0.000" } }
If we cannot match the input search parameters to a record then no results will be returned. The result would appear as follows:
{ "datafinder": { "version": "2.0", "query-id": "xxx", "input-query": { "FirstName": "John", "LastName": "Doe", "EmailAddr": "john.doe@domain.com" }, "num-results": 0, "query-time": "0.138", "page-time": "0.193" } }
Search for social handles using an email address:
https://api.datafinder.com/v2/qdf.php?k2=key&service=social&d_email=john.doe@domain.com
{ "datafinder": { "version": "2.0", "query-id": "b999a3acdc941aa030d87530a180c425", "results": [ { "EmailAddr": "john.doe@domain.com", "FBUID": "1446039788", "FBName": "John Doe", "FBURL": "\/john.doe", "FirstName": "John", "LastName": "Doe" } ], "input-query": { "EmailAddr": "john.doe@domain.com", "Username": "john.doe", "Domain": "domain.com" }, "num-results": 1, "query-time": "0.029" } }
We use cookies to give you the best experience on our website. By clicking "OK" and continuing to use this site, you agree that this is OK. For more information, see our Privacy Policy.
The services and data we provide are intended to help you grow your business and better connect with your customers. Here are some examples of the intended usage of the data we provide:
There are some uses of our data that are prohibited. For example, Datafinder cannot be used for:
It is your responsibility to comply with the Fair Credit Reporting Act (FCRA) and all applicable laws in your use of the data. This includes your compliance with the Do Not Call Registry and with the CAN SPAM Act.
At any time, please review our Terms of Service and Privacy Policy
Select a list below to import from .
We recommend selecting lists with less than 50,000 records
You have imported records.
Select an export option below:
Once this process begins it cannot be undone.
Once this process begins it cannot be undone.
Datafinder's Social Handle Append API service enables you to programmatically append Social Handles to your customer or prospect email addresses.
Inputs and output:
For a complete list of inputs please see the "Parameters" section. For a complete list of outputs, please see the "Output Fields" section.