API Documentation

Enrich your data via API

With Orbitly's API, you can enrich leads and contacts programatically. Find emails, phone numbers, and social media profiles simply by sending Orbitly some input data like an email or a LinkedIn profile or a phone number to find additional details about the contact. Check here to see what data you can pass in to get a proper enriched lead response. You can send up to 100 records to be enriched at a time with a single API request, rate limited at 100 requests per minute.

URL endpoint

This is the URL endpoint you will make HTTP requests to in order to get a response for the leads you want enriched. Make sure to use a POST request.

-- CODE language-js -- POST https://app.orbitly.io/api/leads

Authentication

In order to use this API, you must send some info in your HTTP Headers in order to properly authenticate your account. What you will need is your Api Key that you can find when you go to Settings → Account → Developer after you have logged into Orbitly. Be sure to include Bearer in front of your Api Key in the value of your Authorization Header value and set the Content-Type Header value as application/json.

-- CODE language-js -- { Authorization: "Bearer YOUR_API_KEY_HERE", Content-Type: "application/json" }

Request

In your request, you'll need to include some JSON data with your request in order to receive a proper response with enriched records. The main key-value you will need in your JSON for your request is requests with an array of params where you specify the email, or phone, or social media profile, or name + company combination you want to look up. Check here to see what other input params you can send in your request. Optionally, you can specify a required key-value if you want to enrich and use a credit only if a phone or email or LinkedIn profile exists (or other social media profile) so you don't use unnecessary credits if the data you want is not found. You can even use boolean operators like the example below to only look for records if a LinkedIn profile AND either (a phone OR an email) is found. Each successful record enriched will deduct 1 credit from your account.

-- CODE language-js -- { "requests": [ { "params": { "email": ["steve@woz.org"] } }, { "params": { "profile": ["https://www.linkedin.com/in/brianchesky/"] } }, { "params": { "phone": ["17186893174"] } }, { "params": { "name": ["marc benioff"], "company": ["salesforce"] } } ], "required": "profiles.network:linkedin AND (phone_numbers OR emails)" }

Response

Below is an example of a response you'd expect to see from the API request above. As you can see, different records have different data available but as long as a record is found, a credit will be deducted.

-- CODE language-js -- [ { "status": 200, "data": { "orbitly_credits_used": 1, "orbitly_name": "steve wozniak", "orbitly_first_name": "steve", "orbitly_last_name": "wozniak", "orbitly_email": "steve@woz.org", // orbitly_emails is deprecated "orbitly_emails": "steve@woz.org, s_wozniak10@yahoo.com, stevewozniak@comcast.net, a@woz.org, zamudio@inbox.com", "orbitly_phone": "1-408-888-8889", "orbitly_phones": "1-408-888-8889, 4083544444, 1-408-395-5555, 4083545000", "orbitly_current_company": "wheels of zeus", "orbitly_current_company_size": "1-10", "orbitly_current_company_website": "", "orbitly_companies": "wheels of zeus, tenet, sandisk, apple", "orbitly_location": "los gatos, california, united states", "orbitly_linkedin_url": "http://www.linkedin.com/in/steve-wozniak-370116", "orbitly_facebook_url": "", "orbitly_twitter_url": "", "orbitly_medium_url": "", "orbitly_github_url": "", "orbitly_angellist_url": "", "orbitly_gravatar_url": "", "orbitly_klout_url": "", "orbitly_aboutme_url": "" } }, { "status": 200, "data": { "orbitly_credits_used": 1, "orbitly_name": "brian chesky", "orbitly_first_name": "brian", "orbitly_last_name": "chesky", "orbitly_email": "bchesky@gmail.com", // orbitly_emails is deprecated "orbitly_emails": "bchesky@gmail.com", "orbitly_phone": "14014198290", "orbitly_phones": "14014198290", "orbitly_current_company": "brian chesky", "orbitly_current_company_size": "", "orbitly_current_company_website": "", "orbitly_companies": "brian chesky, 3did, airbnb", "orbitly_location": "san francisco, california, united states", "orbitly_linkedin_url": "http://www.linkedin.com/in/brian-chesky-0645924", "orbitly_facebook_url": "http://www.facebook.com/brianchesky", "orbitly_twitter_url": "http://www.twitter.com/bchesky", "orbitly_medium_url": "", "orbitly_github_url": "", "orbitly_angellist_url": "", "orbitly_gravatar_url": "", "orbitly_klout_url": "", "orbitly_aboutme_url": "" } }, { "status": 200, "data": { "orbitly_credits_used": 1, "orbitly_name": "alexis ohanian", "orbitly_first_name": "alexis", "orbitly_last_name": "ohanian", "orbitly_email": "contact@alexisohanian.com", "orbitly_emails": "contact@alexisohanian.com, alexis@breadpig.com", "orbitly_phone": "17186893174", "orbitly_phones": "17186893174", "orbitly_current_company": "das kapital capital", "orbitly_current_company_size": "", "orbitly_current_company_website": "", "orbitly_companies": "das kapital capital, initialized capital, y combinator, condé nast, without their permission, institute on higher awesome studies, pizza hut, breadpig, inc., uva parking & transportation, reddit, inc., reddit, inc., y combinator, hipmunk", "orbitly_location": "san francisco, california, united states", "orbitly_linkedin_url": "http://www.linkedin.com/in/alexis-ohanian-6b55921", "orbitly_facebook_url": "http://www.facebook.com/alexisohanian", "orbitly_twitter_url": "http://www.twitter.com/alexisohanian", "orbitly_medium_url": "", "orbitly_github_url": "http://www.github.com/breadpig", "orbitly_angellist_url": "", "orbitly_gravatar_url": "", "orbitly_klout_url": "", "orbitly_aboutme_url": "http://www.about.me/alexis" } }, { "status": 200, "data": { "orbitly_credits_used": 1, "orbitly_name": "marc benioff", "orbitly_first_name": "marc", "orbitly_last_name": "benioff", "orbitly_email": "marc.benioff@salesforce.com", "orbitly_emails": "marc.benioff@salesforce.com, ceo@salesforce.com, marcb@salesforce.com, benioff@aol.com, m.benioff@salesforce.com, marc@salesforce.com, info@salesforce.com, benioff@rcn.com, benioff@frontiernet.net, benioff@comcast.net", "orbitly_phone": "4159017010", "orbitly_phones": "4159017010, 4152819012", "orbitly_current_company": "salesforce", "orbitly_current_company_size": "10001+", "orbitly_current_company_website": "salesforce.com", "orbitly_companies": "salesforce, oracle, apple", "orbitly_location": "san francisco, california, united states", "orbitly_linkedin_url": "http://www.linkedin.com/in/marcbenioff", "orbitly_facebook_url": "", "orbitly_twitter_url": "http://www.twitter.com/benioff", "orbitly_medium_url": "", "orbitly_github_url": "", "orbitly_angellist_url": "", "orbitly_gravatar_url": "", "orbitly_klout_url": "", "orbitly_aboutme_url": "" } } ]