Tools LinkedIn Pricing API FAQ
Login

Person data APIs

Our immense database of close to half a billion people with their jobs, hobbies, jobs, education, job histories, email addresses and more is a great source for a large variety of activities.

From research and statistical use to HR or sales enablement, we are providing valuable service for a large range of companies and activities.

The worlds largest database at your immediate access

By releasing this API (3/21/2020) we open public access to our entire database of 492+ million people profiles.
This allows to quickly evaluate our service quality at low cost, update your existing data on demand or enhance your existing data.

Try our web based demo
Contact to email demo

API documentation
cURL

We use cURL and URL examples during most of the documentation.

Person reverse lookup

The person_reverse_lookup API is the successfor of our email lookup API.

This API includes all features of the email to contact API but also adds additional methods to search for contact data.

You may currently search for people by their email address or by their linkedin URL.

Cost for email lookups

Each email lookup costs 0.5 Credits, each matched lookup costs an additional 0.8-1.0 Credits (1.3-1.5 Credits per full lookup) depending on export details chosen.

Demonstration and detailed description

Cost for URL lookups

Each URL search costs 0.2 Credits, each matched lookup costs an additional 1.8-2.5 Credits depending on export details chosen.

Base Cost per search is 0.2 Credits
Base Cost per fullfill is 1.8 Credit (additional options can increase cost per fulfill)

For large quantities we provide custom plans, please contact our helpdesk to learn more.

Important parameters

  • export_format [json]
    json: export format is one JSON object
    csv: only on custom demand
  • country_name [string]
    Priorize records from given country by name if multiple records are available
  • human_readable
    pretty print the JSON data (not usable for machine parsing)
  • input_type
    EMAIL This declares the input_list or inputdata parameter to contain email addresses
    URL This declares the input_list or inputdata parameter to contain linkedin URLs (make sure to URL-encode them)
  • Using list: input_list
    Comma separated list of strings, up to 500 emails or URLs per API call
  • Using array: inputdata
    Emails: An array of email addresses, paired with optional first- and/or last- name to increase matching accuracy with short prefixes, up to 100 emails per API call
    URLs: An array of linkedin URLs or alternatively the identification portion of the URL, up to 500 URLs per API call
  • configuration[export_details]
    Choice of: "MINIMAL", "MEDIUM", "FULL"
    • MINIMAL: Person data includes: name, job_title, company.company_name
    • MEDIUM: Fulfillment cost increase: 0.1 Credits
      Person data includes in addition: current location, current company in full details
    • FULL: Fulfillment cost increase: 0.2 Credits
      Person data includes: up to 40 years of job history, education, skills, linkedin profile URL
  • configuration[export_emails]
    This option should only be activated for URL based searches
    Choice of: "true" / "false" or 1 / 0
    • true: matched profiles include their work type email address and mailserver information (if available)
    • false: no email addresses are added into the person profile when fulfilled
API Request #1 - Search by list of URLs
URL
                            https://scraping.services/export?user=_USER@ACCOUNT_&credentials=_CREDENTIALS_&job_type=person_reverse_query&export_format=json&human_readable&configuration[export_details]=FULL&configuration[export_emails]&input_type=URL&input_list=williamhgates,satya-nadella-3145136
# URLs or the identification part provided as comma separated list
API Request #2 - Search by json array of URLs
cURL
                            curl -X POST https://scraping.services/export \
-d user=_USER@ACCOUNT_ \
-d credentials=_CREDENTIALS_ \
-d job_type=person_reverse_query \
-d input_type=URL \
-d configuration[export_details]=MEDIUM \
--data-urlencode json='{ "inputdata": [ "https://www.linkedin.com/in/williamhgates", "satya-nadella-3145136" ] }' \
-d export_format=json \
-d human_readable
# URLs provided as JSON encoded array
# -X POST or -G will both work, POST is recommended
API Request #3 - Search by list of email addresses
URL
                            https://scraping.services/export?user=_USER@ACCOUNT_&credentials=_CREDENTIALS_&job_type=person_reverse_query&export_format=json&human_readable&configuration[export_details]=FULL&input_type=EMAIL&input_list=SatyaN@Microsoft.com,GatesB@Microsoft.com
# emails provided as comma separated list
API Request #4 - Search by json array of email addresses
cURL
                            curl -X POST https://scraping.services/export \
-d user=_USER@ACCOUNT_ \
-d credentials=_CREDENTIALS_ \
-d job_type=person_reverse_query \
-d input_type=EMAIL \
-d configuration[export_details]=MEDIUM \
--data-urlencode json='{ "inputdata": [ "SatyaN@Microsoft.com", "AlfredHitchcock@analyze.only", { "email": "GatesB@Microsoft.com", "first_name": "Bill" }, { "email": "bg@Microsoft.com", "name": "Bill Gates" } ] }' \
-d export_format=json \
-d human_readable
# emails provided as JSON encoded array
# SatyaN@Microsoft.com is without meta information
# AlfredHitchcock@analyze.only demonstrates our email prefix to name analysis
# GatesB@Microsoft.com specifies the first name (not required but increases statistical match rates)
# bg@Microsoft.com specifies the full name which demonstrates our full name analysis
# -X POST or -G will both work, POST is recommended
Response #1 & #2 (FULL details)
JSON
                            {
    "request": {
        "job_type": "person_reverse_query",
        "cost": {
            "type": "credit",
            "total": 5.4,
            "per_search": 0.2,
            "per_fulfillment": 2.5
        },
        "api_version_max": 2,
        "api_version": 1,
        "configuration": {
            "EXPORT_DETAILS": "FULL",
            "EXPORT_EMAILS": "true"
        },
        "statistic": {
            "located": 2,
            "unique": 2,
            "missed": 0
        }
    },
    "results": {
        "satya-nadella-3145136": {
            "person": {
                "id": 113063,
                "scraping_services_id": 113063,
                "linkedin_id": "satya-nadella-3145136",
                "linkedin_profile_url": "https://www.linkedin.com/in/satya-nadella-3145136",
                "last_name": "Nadella",
                "first_name": "Satya",
                "v_extension": {
                    "gender": "female",
                    "industry_from_job": false,
                    "seniority": "Higher Management",
                    "job_functions": "Information Technology,Operations",
                    "job_group": "Manager: Chief Executive Officer"
                },
                "location": {
                    "country_name": "United States",
                    "state_name": "Washington",
                    "city_name": "Redmond"
                },
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft",
                    "company_intern_id": "microsoft",
                    "scraping_services_id": 8261458,
                    "address_hq": "1 Microsoft Way Redmond, WA 98052 United States",
                    "website": "http://www.microsoft.com",
                    "size_min": 10001,
                    "size_max": 10001,
                    "summary": "At Microsoft, our mission is to empower every person and every organization on the planet to achieve more. Our mission is grounded in both the world in which we live and the future we strive to create. Today, we live in a mobile-first, cloud-first world, and the transformation we are driving across our businesses is designed to enable Microsoft and our customers to thrive in this world. \n\nWe do business in 170 countries and are made up of 114,000 passionate employees dedicated to fulfilling our mission of helping you and your organization achieve more.\n",
                    "location": {
                        "country_name": "United States",
                        "state_name": "Washington",
                        "city_name": "Redmond",
                        "zip_code": "98052"
                    },
                    "founded_date": "1975",
                    "industry": "Computer Software"
                },
                "job_history": [
                    {
                        "job_title": "CEO",
                        "location": {
                            "city_name": "Seattle",
                            "country_name": "United States",
                            "state_name": "Washington"
                        },
                        "company_name": "Microsoft",
                        "company_intern_id": "microsoft",
                        "start": "February 2014"
                    }
                ],
                "snapshots": {
                    "2018/3": {
                        "company_name": "Microsoft",
                        "job_title": "CEO"
                    },
                    "2018/5": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/7": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/8": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/10": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/11": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/12": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/1": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/2": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/3": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Redmond"
                        }
                    },
                    "2019/4": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Redmond"
                        }
                    },
                    "2019/5": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Redmond"
                        }
                    },
                    "2019/12": {
                        "company_name": "Microsoft",
                        "job_title": "CEO",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Redmond"
                        }
                    }
                },
                "interests": [
                    "Technology",
                    "cricket",
                    "poetry and literature",
                    "spending time with family"
                ],
                "education": [
                    {
                        "education_org": "The University of Chicago Booth School of Business",
                        "end": "1996",
                        "start": "1994"
                    },
                    {
                        "education_org": "Mangalore University",
                        "degrees": [
                            "Bachelor’s Degree, Electrical Engineering"
                        ]
                    },
                    {
                        "education_org": "University of Wisconsin-Milwaukee",
                        "degrees": [
                            "Master’s Degree, Computer Science"
                        ]
                    }
                ],
                "email": {
                    "address_primary": "satyan@microsoft.com",
                    "score_primary": "100_mailserver_verified",
                    "mailserver_primary": "friendly"
                },
                "updated": "2020-02-01"
            }
        },
        "williamhgates": {
            "person": {
                "id": 13895,
                "scraping_services_id": 13895,
                "linkedin_id": "williamhgates",
                "linkedin_profile_url": "https://www.linkedin.com/in/williamhgates",
                "last_name": "Gates",
                "first_name": "Bill",
                "v_extension": {
                    "gender": "male",
                    "industry_from_job": false,
                    "seniority": "Higher Management",
                    "job_functions": "Entrepreneurship,Operations",
                    "job_group": "Manager: Chairman"
                },
                "num_connections": 4,
                "location": {
                    "country_name": "United States",
                    "state_name": "Washington",
                    "city_name": "Seattle"
                },
                "job_title": "Co-chair",
                "company": {
                    "company_name": "Bill & Melinda Gates Foundation",
                    "company_intern_id": "bill-&-melinda-gates-foundation",
                    "scraping_services_id": 2703687,
                    "address_hq": "500 5th Ave North Seattle, WA 98109 United States",
                    "website": "http://www.gatesfoundation.org",
                    "size_min": 1001,
                    "size_max": 5000,
                    "summary": "Guided by the belief that every life has equal value, the Bill & Melinda Gates Foundation works to help all people lead healthy, productive lives. In developing countries, it focuses on improving people’s health and giving them the chance to lift themselves out of hunger and extreme poverty. In the United States, it seeks to ensure that all people—especially those with the fewest resources—have access to the opportunities they need to succeed in school and life. Based in Seattle, the foundation is led by CEO Sue Desmond-Hellmann and co-chair William H. Gates Sr., under the direction of Bill and Melinda Gates and Warren Buffett.",
                    "location": {
                        "country_name": "United States",
                        "state_name": "Washington",
                        "city_name": "Seattle",
                        "zip_code": "98109"
                    },
                    "founded_date": "2000",
                    "industry": "Philanthropy"
                },
                "job_history": [
                    {
                        "job_title": "Co-chair",
                        "company_name": "Bill & Melinda Gates Foundation",
                        "company_intern_id": "bill-&-melinda-gates-foundation",
                        "start": "2000"
                    },
                    {
                        "job_title": "Co-founder",
                        "company_name": "Microsoft",
                        "company_intern_id": "microsoft",
                        "start": "1975"
                    }
                ],
                "snapshots": {
                    "2018/3": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair"
                    },
                    "2018/5": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/7": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/8": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/9": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": false
                        }
                    },
                    "2018/10": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/11": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2018/12": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/1": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/2": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/3": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/4": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    },
                    "2019/5": {
                        "company_name": "Bill & Melinda Gates Foundation",
                        "job_title": "Co-chair",
                        "location": {
                            "country_name": "United States",
                            "state_name": "Washington",
                            "city_name": "Seattle"
                        }
                    }
                },
                "interests": [
                    "Technology and innovation",
                    "bridge",
                    "developing new vaccines",
                    "energy policy",
                    "eradicating polio",
                    "helping every child get a great education",
                    "helping the world's poorest improve their lives",
                    "philanthropy and volunteerism",
                    "reading",
                    "research and development",
                    "taking interesting courses online",
                    "tennis.",
                    "traveling with family"
                ],
                "education": [
                    {
                        "education_org": "Harvard University",
                        "end": "1975",
                        "start": "1973"
                    },
                    {
                        "education_org": "Lakeside School, Seattle"
                    }
                ],
                "email": {
                    "address_primary": "bill.gates@gatesfoundation.org",
                    "score_primary": "95_web_aggregated",
                    "mailserver_primary": "catch_all"
                },
                "updated": "2020-03-01"
            }
        }
    }
}
                        
Response #3 (FULL details)
JSON
                            {
  "request": {
    "job_type": "email_reverse_query",
    "cost": {
      "type": "credit",
      "total": 3,
      "per_search": 0.5,
      "per_fulfillment": 1
    },
    "api_version_max": 2,
    "api_version": 1,
    "configuration": {
      "EXPORT_DETAILS": "FULL"
    },
    "statistic": {
      "located": 2,
      "unique": 0,
      "missed": 0
    }
  },
  "results": {
    "SatyaN@Microsoft.com": {
      "analysis": {
        "email_pattern": "{first}{l}",
        "name_from_email": {
          "{l}": "N",
          "{first}": "Satya",
          "pattern": "{first}{l}",
          "certainty": 0.882
        },
        "persons_matched": 3
      },
      "person": {
        "id": 113063,
        "scraping_services_id": 113063,
        "linkedin_id": "satya-nadella-3145136",
        "linkedin_profile_url": "https://www.linkedin.com/in/satya-nadella-3145136",
        "last_name": "Nadella",
        "first_name": "Satya",
        "num_jobs": 4,
        "location": {
          "country_name": "United States",
          "state_name": "Washington",
          "city_name": "Redmond"
        },
        "job_title": "CEO",
        "company": {
          "company_name": "Microsoft",
          "company_intern_id": "microsoft",
          "scraping_services_id": 8261458,
          "address_hq": "1 Microsoft Way Redmond, WA 98052 United States",
          "website": "http://www.microsoft.com",
          "size_min": 10001,
          "size_max": 10001,
          "summary": "At Microsoft, our mission is to empower every person and every organization on the planet to achieve more. Our mission is grounded in both the world in which we live and the future we strive to create. Today, we live in a mobile-first, cloud-first world, and the transformation we are driving across our businesses is designed to enable Microsoft and our customers to thrive in this world. \n\nWe do business in 170 countries and are made up of 114,000 passionate employees dedicated to fulfilling our mission of helping you and your organization achieve more.\n",
          "location": {
            "country_name": "United States",
            "state_name": "Washington",
            "city_name": "Redmond",
            "zip_code": "98052"
          },
          "founded_date": "1975",
          "industry": "Computer Software"
        },
        "job_history": [
          {
            "job_title": "CEO",
            "location": {
              "city_name": "Seattle",
              "country_name": "United States",
              "state_name": "Washington"
            },
            "company_name": "Microsoft",
            "company_intern_id": "microsoft",
            "start": "February 2014"
          }
        ],
        "job_history_extended": {
          "2018/3": {
            "company_name": "Microsoft",
            "job_title": "CEO"
          },
          "2018/5": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "state_name": "Washington",
              "city_name": "Seattle"
            }
          },
          "2019/3": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "state_name": "Washington",
              "city_name": "Redmond"
            }
          }
        },
        "interests": [
          "Technology",
          "cricket",
          "poetry and literature",
          "spending time with family"
        ],
        "education": [
          {
            "education_org": "The University of Chicago Booth School of Business",
            "end": "1996",
            "start": "1994"
          },
          {
            "education_org": "Mangalore University",
            "degrees": [
              "Bachelor’s Degree, Electrical Engineering"
            ]
          },
          {
            "education_org": "University of Wisconsin-Milwaukee",
            "degrees": [
              "Master’s Degree, Computer Science"
            ]
          }
        ],
        "also_viewed": [
          "satya-nadella-3145136",
          "rishic1",
          "mdell",
          "rsanghvi",
          "randizuckerberg",
          "gayathri-rajan-81b226",
          "punitsoni",
          "marissamayer",
          "saverin",
          "williamhgates"
        ],
        "updated": "2019-09-01",
        "certainty": 1,
        "is_unique": false
      },
      "email_company": {
        "scse_n_id": null,
        "linkedin_url": "https://www.linkedin.com/company/microsoft",
        "company_name": "Microsoft Corporation",
        "country_name": "United States",
        "state_name": "Washington",
        "city_name": "Redmond",
        "postal_code": "98052",
        "summary": "Microsoft Corporation develops, licenses, and supports software, services, devices, and solutions worldwide. Its company's Productivity and Business Processes segment offers Office 365 commercial products and services for businesses, such as Office, Exchange, SharePoint, Skype for Business, Microsoft Teams, and related Client Access Licenses (CALs); Office 365 consumer services, including Skype, Outlook.com, and OneDrive; LinkedIn online professional network; and Dynamics business solutions comprising financial management, enterprise resource planning, customer relationship management, supply chain management, and analytics applications for small and medium businesses, large organizations, and divisions of enterprises. The company's Intelligent Cloud segment licenses server products and cloud services, such as SQL Server, Windows Server, Visual Studio, System Center, and related CALs, as well as Azure, a cloud platform; enterprise services, including premier support and Microsoft consulting services to assist customers in developing, deploying, and managing Microsoft server and desktop solutions, as well as providing training and certification to developers and IT professionals on Microsoft products. Its More Personal Computing segment offers Windows OEM, volume, and other non-volume licensing of the Windows operating system; patent licensing, Windows Internet of Things, and MSN display advertising; devices comprising Surface, PC accessories, and other intelligent devices; Xbox hardware and software and services; and Bing and Bing Ads search advertising. The company markets and distributes its products through original equipment manufacturers, distributors, and resellers, as well as through online and Microsoft retail stores. Microsoft Corporation has collaboration with E.ON; a strategic alliance with Nielsen Holdings plc; and a strategic collaboration with Mastercard Incorporated. The company was founded in 1975 and is headquartered in Redmond, Washington.",
        "employee_count": 131000,
        "employee_count_span": "131000-131000",
        "employee_available": null,
        "phone": "425-882-8080",
        "address_hq": "One Microsoft Way",
        "website": "http://www.microsoft.com",
        "website_alt": null,
        "industry_linkedin": "Computer Software",
        "industry_alt": "Software - Infrastructure",
        "founded_date": "1975",
        "specialities": null,
        "stock_symbol": "MSFT",
        "stock_exchange": "NMS",
        "last_updated": 2019
      }
    },
    "GatesB@Microsoft.com": {
      "analysis": {
        "email_pattern": "{last}{f}",
        "name_from_email": {
          "{f}": "B",
          "{last}": "Gates",
          "pattern": "{last}{f}",
          "certainty": 0.882
        },
        "persons_matched": 4
      },
      "person": {
        "id": 171595885,
        "scraping_services_id": 171595885,
        "linkedin_id": "bill-gates-9a3782104",
        "linkedin_profile_url": "https://www.linkedin.com/in/bill-gates-9a3782104",
        "last_name": "Gates",
        "first_name": "Bill",
        "location": {
          "country_name": "United States",
          "state_name": "Georgia",
          "city_name": "Atlanta"
        },
        "industry": "Internet",
        "job_title": "CEO",
        "company": {
          "company_name": "Microsoft",
          "company_intern_id": "microsoft",
          "scraping_services_id": 8261458,
          "address_hq": "1 Microsoft Way Redmond, WA 98052 United States",
          "website": "http://www.microsoft.com",
          "size_min": 10001,
          "size_max": 10001,
          "summary": "At Microsoft, our mission is to empower every person and every organization on the planet to achieve more. Our mission is grounded in both the world in which we live and the future we strive to create. Today, we live in a mobile-first, cloud-first world, and the transformation we are driving across our businesses is designed to enable Microsoft and our customers to thrive in this world. \n\nWe do business in 170 countries and are made up of 114,000 passionate employees dedicated to fulfilling our mission of helping you and your organization achieve more.\n",
          "location": {
            "country_name": "United States",
            "state_name": "Washington",
            "city_name": "Redmond",
            "zip_code": "98052"
          },
          "founded_date": "1975",
          "industry": "Computer Software"
        },
        "job_history_extended": {
          "2018/1": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "city_name": "Atlanta"
            }
          }
        },
        "also_viewed": [
          "mark-cuban-06a0755b",
          "bill-gates-b3038410",
          "emusk",
          "julia-golovina-05b74787",
          "isabella-amor-76291343",
          "walter-rolls-3459ba99",
          "rbranson",
          "billgatessrclarke",
          "bill-gates-b1a606b0",
          "williamhgates",
          "bill-n-melinda-gates-foundation-310737bb",
          "георгий-а-25208b81",
          "williamcgates",
          "donald-trump-a9887b55",
          "jan-hürlimann-05264610b"
        ],
        "updated": "2018-04-01",
        "certainty": 1,
        "is_unique": false
      },
      "email_company": {
        "scse_n_id": null,
        "linkedin_url": "https://www.linkedin.com/company/microsoft",
        "company_name": "Microsoft Corporation",
        "country_name": "United States",
        "state_name": "Washington",
        "city_name": "Redmond",
        "postal_code": "98052",
        "summary": "Microsoft Corporation develops, licenses, and supports software, services, devices, and solutions worldwide. Its company's Productivity and Business Processes segment offers Office 365 commercial products and services for businesses, such as Office, Exchange, SharePoint, Skype for Business, Microsoft Teams, and related Client Access Licenses (CALs); Office 365 consumer services, including Skype, Outlook.com, and OneDrive; LinkedIn online professional network; and Dynamics business solutions comprising financial management, enterprise resource planning, customer relationship management, supply chain management, and analytics applications for small and medium businesses, large organizations, and divisions of enterprises. The company's Intelligent Cloud segment licenses server products and cloud services, such as SQL Server, Windows Server, Visual Studio, System Center, and related CALs, as well as Azure, a cloud platform; enterprise services, including premier support and Microsoft consulting services to assist customers in developing, deploying, and managing Microsoft server and desktop solutions, as well as providing training and certification to developers and IT professionals on Microsoft products. Its More Personal Computing segment offers Windows OEM, volume, and other non-volume licensing of the Windows operating system; patent licensing, Windows Internet of Things, and MSN display advertising; devices comprising Surface, PC accessories, and other intelligent devices; Xbox hardware and software and services; and Bing and Bing Ads search advertising. The company markets and distributes its products through original equipment manufacturers, distributors, and resellers, as well as through online and Microsoft retail stores. Microsoft Corporation has collaboration with E.ON; a strategic alliance with Nielsen Holdings plc; and a strategic collaboration with Mastercard Incorporated. The company was founded in 1975 and is headquartered in Redmond, Washington.",
        "employee_count": 131000,
        "employee_count_span": "131000-131000",
        "employee_available": null,
        "phone": "425-882-8080",
        "address_hq": "One Microsoft Way",
        "website": "http://www.microsoft.com",
        "website_alt": null,
        "industry_linkedin": "Computer Software",
        "industry_alt": "Software - Infrastructure",
        "founded_date": "1975",
        "specialities": null,
        "stock_symbol": "MSFT",
        "stock_exchange": "NMS",
        "last_updated": 2019
      }
    }
  }
}
                        
Response #4 (MINIMAL details)
CSV
                            {
    "request": {
        "job_type": "email_reverse_query",
        "cost": {
            "type": "credit",
            "total": 4.4,
            "per_search": 0.5,
            "per_fulfillment": 0.8
        },
        "api_version_max": 2,
        "api_version": 1,
        "configuration": {
            "EXPORT_DETAILS": "MINIMAL"
        },
        "statistic": {
            "located": 3,
            "unique": 2,
            "missed": 1
        }
    },
    "results": {
        "SatyaN@Microsoft.com": {
            "analysis": {
                "email_pattern": "{first}{l}",
                "name_from_email": {
                    "{l}": "N",
                    "{first}": "Satya",
                    "pattern": "{first}{l}",
                    "certainty": 0.882
                },
                "persons_matched": 3
            },
            "person": {
                "scraping_services_id": 113063,
                "last_name": "Nadella",
                "first_name": "Satya",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": false
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        },
        "MorganF@analyze.only": {
            "analysis": {
                "email_pattern": "{last}{f}",
                "name_from_email": {
                    "{f}": "F",
                    "{last}": "Morgan",
                    "pattern": "{last}{f}",
                    "certainty": 0.9
                },
                "persons_matched": 0
            },
            "person": false,
            "email_company": {
                "company_name": null
            }
        },
        "GatesB@Microsoft.com": {
            "analysis": {
                "email_pattern": "{last}{f}",
                "name_from_email": {
                    "{f}": "B",
                    "{last}": "Gates",
                    "pattern": "{last}{f}",
                    "certainty": 0.882
                },
                "persons_matched": 1
            },
            "person": {
                "scraping_services_id": 171595885,
                "last_name": "Gates",
                "first_name": "Bill",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": true
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        },
        "bg@Microsoft.com": {
            "analysis": {
                "provided_full_name": {
                    "{first}": "Bill",
                    "{middle}": "",
                    "{last}": "Gates",
                    "certainty": 1
                },
                "email_pattern": null,
                "name_from_email": null,
                "persons_matched": 1
            },
            "person": {
                "scraping_services_id": 171595885,
                "last_name": "Gates",
                "first_name": "Bill",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": true
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        }
    }
}
                        

Email to contact reversal

The email_to_contact API gives you an edge in finding highly detailed data profiles from people based on their email address.

This API will analyze the submitted email addresses into first and last name, the domain into the company profile and then look in our employee database for this employee.

The core feature of this API is that it can reverse email addresses that are not even present in our database of 100M business email addresses.

Cost

Each email lookup costs 0.5 Credits, each matched lookup costs an additional 0.8-1.0 Credits (1.3-1.5 Credits per full lookup) depending on export details chosen.

This is the license to use for smaller volumes, on large quantities (hundred thousands up to millions of contacts) we provide custom plans.

Demonstration and detailed description

Important parameters

  • export_format [json]
    json: export format is one JSON object
    csv: only on custom demand
  • country_name [string]
    Priorize records from given country by name if multiple records are available
  • human_readable
    pretty print the JSON data (not for machine parsing)
  • a) email_list
    Comma separated list of email addresses, up to 500 emails per API call
  • b) emaildata
    An array of email addresses, paired with optional first- and/or last- name to increase matching accuracy on short prefixes, up to 100 emails per API call
  • configuration[export_details]
    Choice of: MINIMAL, MEDIUM, FULL
    • MINIMAL: Fulfillment cost: 0.8 Credits
      Person data includes: name, job_title, company.company_name
    • MEDIUM: Fulfillment cost: 0.9 Credits
      Person data includes in addition: current location, current company in full details
    • FULL: Fulfillment cost: 1.0 Credits
      Person data includes: up to 40 years of job history, education, skills, linkedin profile URL
Request 1
URL
                            https://scraping.services/export?user=_USER@ACCOUNT_&credentials=_CREDENTIALS_&job_type=email_reverse_query&export_format=json&human_readable&configuration[export_details]=FULL&email_list=SatyaN@Microsoft.com,GatesB@Microsoft.com
# emails provided as comma separated list
API request 2
cURL
                            curl -X POST https://scraping.services/export \
-d user=_USER@ACCOUNT_ \
-d credentials=_CREDENTIALS_ \
-d job_type=email_reverse_query \
-d configuration[export_details]=MEDIUM \
--data-urlencode json='{ "emaildata": [ "SatyaN@Microsoft.com", "AlfredHitchcock@analyze.only", { "email": "GatesB@Microsoft.com", "first_name": "Bill" }, { "email": "bg@Microsoft.com", "name": "Bill Gates" } ] }' \
-d export_format=json \
-d human_readable
# emails provided as JSON encoded array
# SatyaN@Microsoft.com is without meta information
# AlfredHitchcock@analyze.only demonstrates our email prefix to name analysis
# GatesB@Microsoft.com specifies the first name (not required but increases statistical match rates)
# bg@Microsoft.com specifies the full name which demonstrates our full name analysis
# -X POST or -G will both work, POST is recommended
Response 1 (FULL details)
JSON
                            {
  "request": {
    "job_type": "email_reverse_query",
    "cost": {
      "type": "credit",
      "total": 3,
      "per_search": 0.5,
      "per_fulfillment": 1
    },
    "api_version_max": 2,
    "api_version": 1,
    "configuration": {
      "EXPORT_DETAILS": "FULL"
    },
    "statistic": {
      "located": 2,
      "unique": 0,
      "missed": 0
    }
  },
  "results": {
    "SatyaN@Microsoft.com": {
      "analysis": {
        "email_pattern": "{first}{l}",
        "name_from_email": {
          "{l}": "N",
          "{first}": "Satya",
          "pattern": "{first}{l}",
          "certainty": 0.882
        },
        "persons_matched": 3
      },
      "person": {
        "id": 113063,
        "scraping_services_id": 113063,
        "linkedin_id": "satya-nadella-3145136",
        "linkedin_profile_url": "https://www.linkedin.com/in/satya-nadella-3145136",
        "last_name": "Nadella",
        "first_name": "Satya",
        "num_jobs": 4,
        "location": {
          "country_name": "United States",
          "state_name": "Washington",
          "city_name": "Redmond"
        },
        "job_title": "CEO",
        "company": {
          "company_name": "Microsoft",
          "company_intern_id": "microsoft",
          "scraping_services_id": 8261458,
          "address_hq": "1 Microsoft Way Redmond, WA 98052 United States",
          "website": "http://www.microsoft.com",
          "size_min": 10001,
          "size_max": 10001,
          "summary": "At Microsoft, our mission is to empower every person and every organization on the planet to achieve more. Our mission is grounded in both the world in which we live and the future we strive to create. Today, we live in a mobile-first, cloud-first world, and the transformation we are driving across our businesses is designed to enable Microsoft and our customers to thrive in this world. \n\nWe do business in 170 countries and are made up of 114,000 passionate employees dedicated to fulfilling our mission of helping you and your organization achieve more.\n",
          "location": {
            "country_name": "United States",
            "state_name": "Washington",
            "city_name": "Redmond",
            "zip_code": "98052"
          },
          "founded_date": "1975",
          "industry": "Computer Software"
        },
        "job_history": [
          {
            "job_title": "CEO",
            "location": {
              "city_name": "Seattle",
              "country_name": "United States",
              "state_name": "Washington"
            },
            "company_name": "Microsoft",
            "company_intern_id": "microsoft",
            "start": "February 2014"
          }
        ],
        "job_history_extended": {
          "2018/3": {
            "company_name": "Microsoft",
            "job_title": "CEO"
          },
          "2018/5": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "state_name": "Washington",
              "city_name": "Seattle"
            }
          },
          "2019/3": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "state_name": "Washington",
              "city_name": "Redmond"
            }
          }
        },
        "interests": [
          "Technology",
          "cricket",
          "poetry and literature",
          "spending time with family"
        ],
        "education": [
          {
            "education_org": "The University of Chicago Booth School of Business",
            "end": "1996",
            "start": "1994"
          },
          {
            "education_org": "Mangalore University",
            "degrees": [
              "Bachelor’s Degree, Electrical Engineering"
            ]
          },
          {
            "education_org": "University of Wisconsin-Milwaukee",
            "degrees": [
              "Master’s Degree, Computer Science"
            ]
          }
        ],
        "also_viewed": [
          "satya-nadella-3145136",
          "rishic1",
          "mdell",
          "rsanghvi",
          "randizuckerberg",
          "gayathri-rajan-81b226",
          "punitsoni",
          "marissamayer",
          "saverin",
          "williamhgates"
        ],
        "updated": "2019-09-01",
        "certainty": 1,
        "is_unique": false
      },
      "email_company": {
        "scse_n_id": null,
        "linkedin_url": "https://www.linkedin.com/company/microsoft",
        "company_name": "Microsoft Corporation",
        "country_name": "United States",
        "state_name": "Washington",
        "city_name": "Redmond",
        "postal_code": "98052",
        "summary": "Microsoft Corporation develops, licenses, and supports software, services, devices, and solutions worldwide. Its company's Productivity and Business Processes segment offers Office 365 commercial products and services for businesses, such as Office, Exchange, SharePoint, Skype for Business, Microsoft Teams, and related Client Access Licenses (CALs); Office 365 consumer services, including Skype, Outlook.com, and OneDrive; LinkedIn online professional network; and Dynamics business solutions comprising financial management, enterprise resource planning, customer relationship management, supply chain management, and analytics applications for small and medium businesses, large organizations, and divisions of enterprises. The company's Intelligent Cloud segment licenses server products and cloud services, such as SQL Server, Windows Server, Visual Studio, System Center, and related CALs, as well as Azure, a cloud platform; enterprise services, including premier support and Microsoft consulting services to assist customers in developing, deploying, and managing Microsoft server and desktop solutions, as well as providing training and certification to developers and IT professionals on Microsoft products. Its More Personal Computing segment offers Windows OEM, volume, and other non-volume licensing of the Windows operating system; patent licensing, Windows Internet of Things, and MSN display advertising; devices comprising Surface, PC accessories, and other intelligent devices; Xbox hardware and software and services; and Bing and Bing Ads search advertising. The company markets and distributes its products through original equipment manufacturers, distributors, and resellers, as well as through online and Microsoft retail stores. Microsoft Corporation has collaboration with E.ON; a strategic alliance with Nielsen Holdings plc; and a strategic collaboration with Mastercard Incorporated. The company was founded in 1975 and is headquartered in Redmond, Washington.",
        "employee_count": 131000,
        "employee_count_span": "131000-131000",
        "employee_available": null,
        "phone": "425-882-8080",
        "address_hq": "One Microsoft Way",
        "website": "http://www.microsoft.com",
        "website_alt": null,
        "industry_linkedin": "Computer Software",
        "industry_alt": "Software - Infrastructure",
        "founded_date": "1975",
        "specialities": null,
        "stock_symbol": "MSFT",
        "stock_exchange": "NMS",
        "last_updated": 2019
      }
    },
    "GatesB@Microsoft.com": {
      "analysis": {
        "email_pattern": "{last}{f}",
        "name_from_email": {
          "{f}": "B",
          "{last}": "Gates",
          "pattern": "{last}{f}",
          "certainty": 0.882
        },
        "persons_matched": 4
      },
      "person": {
        "id": 171595885,
        "scraping_services_id": 171595885,
        "linkedin_id": "bill-gates-9a3782104",
        "linkedin_profile_url": "https://www.linkedin.com/in/bill-gates-9a3782104",
        "last_name": "Gates",
        "first_name": "Bill",
        "location": {
          "country_name": "United States",
          "state_name": "Georgia",
          "city_name": "Atlanta"
        },
        "industry": "Internet",
        "job_title": "CEO",
        "company": {
          "company_name": "Microsoft",
          "company_intern_id": "microsoft",
          "scraping_services_id": 8261458,
          "address_hq": "1 Microsoft Way Redmond, WA 98052 United States",
          "website": "http://www.microsoft.com",
          "size_min": 10001,
          "size_max": 10001,
          "summary": "At Microsoft, our mission is to empower every person and every organization on the planet to achieve more. Our mission is grounded in both the world in which we live and the future we strive to create. Today, we live in a mobile-first, cloud-first world, and the transformation we are driving across our businesses is designed to enable Microsoft and our customers to thrive in this world. \n\nWe do business in 170 countries and are made up of 114,000 passionate employees dedicated to fulfilling our mission of helping you and your organization achieve more.\n",
          "location": {
            "country_name": "United States",
            "state_name": "Washington",
            "city_name": "Redmond",
            "zip_code": "98052"
          },
          "founded_date": "1975",
          "industry": "Computer Software"
        },
        "job_history_extended": {
          "2018/1": {
            "company_name": "Microsoft",
            "job_title": "CEO",
            "location": {
              "country_name": "United States",
              "city_name": "Atlanta"
            }
          }
        },
        "also_viewed": [
          "mark-cuban-06a0755b",
          "bill-gates-b3038410",
          "emusk",
          "julia-golovina-05b74787",
          "isabella-amor-76291343",
          "walter-rolls-3459ba99",
          "rbranson",
          "billgatessrclarke",
          "bill-gates-b1a606b0",
          "williamhgates",
          "bill-n-melinda-gates-foundation-310737bb",
          "георгий-а-25208b81",
          "williamcgates",
          "donald-trump-a9887b55",
          "jan-hürlimann-05264610b"
        ],
        "updated": "2018-04-01",
        "certainty": 1,
        "is_unique": false
      },
      "email_company": {
        "scse_n_id": null,
        "linkedin_url": "https://www.linkedin.com/company/microsoft",
        "company_name": "Microsoft Corporation",
        "country_name": "United States",
        "state_name": "Washington",
        "city_name": "Redmond",
        "postal_code": "98052",
        "summary": "Microsoft Corporation develops, licenses, and supports software, services, devices, and solutions worldwide. Its company's Productivity and Business Processes segment offers Office 365 commercial products and services for businesses, such as Office, Exchange, SharePoint, Skype for Business, Microsoft Teams, and related Client Access Licenses (CALs); Office 365 consumer services, including Skype, Outlook.com, and OneDrive; LinkedIn online professional network; and Dynamics business solutions comprising financial management, enterprise resource planning, customer relationship management, supply chain management, and analytics applications for small and medium businesses, large organizations, and divisions of enterprises. The company's Intelligent Cloud segment licenses server products and cloud services, such as SQL Server, Windows Server, Visual Studio, System Center, and related CALs, as well as Azure, a cloud platform; enterprise services, including premier support and Microsoft consulting services to assist customers in developing, deploying, and managing Microsoft server and desktop solutions, as well as providing training and certification to developers and IT professionals on Microsoft products. Its More Personal Computing segment offers Windows OEM, volume, and other non-volume licensing of the Windows operating system; patent licensing, Windows Internet of Things, and MSN display advertising; devices comprising Surface, PC accessories, and other intelligent devices; Xbox hardware and software and services; and Bing and Bing Ads search advertising. The company markets and distributes its products through original equipment manufacturers, distributors, and resellers, as well as through online and Microsoft retail stores. Microsoft Corporation has collaboration with E.ON; a strategic alliance with Nielsen Holdings plc; and a strategic collaboration with Mastercard Incorporated. The company was founded in 1975 and is headquartered in Redmond, Washington.",
        "employee_count": 131000,
        "employee_count_span": "131000-131000",
        "employee_available": null,
        "phone": "425-882-8080",
        "address_hq": "One Microsoft Way",
        "website": "http://www.microsoft.com",
        "website_alt": null,
        "industry_linkedin": "Computer Software",
        "industry_alt": "Software - Infrastructure",
        "founded_date": "1975",
        "specialities": null,
        "stock_symbol": "MSFT",
        "stock_exchange": "NMS",
        "last_updated": 2019
      }
    }
  }
}
                        
Response 2 (MINIMAL details)
CSV
                            {
    "request": {
        "job_type": "email_reverse_query",
        "cost": {
            "type": "credit",
            "total": 4.4,
            "per_search": 0.5,
            "per_fulfillment": 0.8
        },
        "api_version_max": 2,
        "api_version": 1,
        "configuration": {
            "EXPORT_DETAILS": "MINIMAL"
        },
        "statistic": {
            "located": 3,
            "unique": 2,
            "missed": 1
        }
    },
    "results": {
        "SatyaN@Microsoft.com": {
            "analysis": {
                "email_pattern": "{first}{l}",
                "name_from_email": {
                    "{l}": "N",
                    "{first}": "Satya",
                    "pattern": "{first}{l}",
                    "certainty": 0.882
                },
                "persons_matched": 3
            },
            "person": {
                "scraping_services_id": 113063,
                "last_name": "Nadella",
                "first_name": "Satya",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": false
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        },
        "MorganF@analyze.only": {
            "analysis": {
                "email_pattern": "{last}{f}",
                "name_from_email": {
                    "{f}": "F",
                    "{last}": "Morgan",
                    "pattern": "{last}{f}",
                    "certainty": 0.9
                },
                "persons_matched": 0
            },
            "person": false,
            "email_company": {
                "company_name": null
            }
        },
        "GatesB@Microsoft.com": {
            "analysis": {
                "email_pattern": "{last}{f}",
                "name_from_email": {
                    "{f}": "B",
                    "{last}": "Gates",
                    "pattern": "{last}{f}",
                    "certainty": 0.882
                },
                "persons_matched": 1
            },
            "person": {
                "scraping_services_id": 171595885,
                "last_name": "Gates",
                "first_name": "Bill",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": true
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        },
        "bg@Microsoft.com": {
            "analysis": {
                "provided_full_name": {
                    "{first}": "Bill",
                    "{middle}": "",
                    "{last}": "Gates",
                    "certainty": 1
                },
                "email_pattern": null,
                "name_from_email": null,
                "persons_matched": 1
            },
            "person": {
                "scraping_services_id": 171595885,
                "last_name": "Gates",
                "first_name": "Bill",
                "job_title": "CEO",
                "company": {
                    "company_name": "Microsoft"
                },
                "certainty": 1,
                "is_unique": true
            },
            "email_company": {
                "company_name": "Microsoft Corporation"
            }
        }
    }
}