Frequently Asked Questions

What is this about?

JAIDE-ABI stands for "JAIDE's Address Book Importer" and is a Java-based library for importing address book entries from web-based mail clients (also known as "webmailers") as well as social networks, such as XING and LinkedIn. We're calling them all "platforms" since they can be any type of service that provides address book management.

Why should I pick you and not competitor X?

There are lots of reasons why you should choose us but the three important ones are:
→ What you see here is a hand-crafted, German-engineered and actively maintained product that actually works.
→ The data stays on your server and does not get transferred over the wire to some third-party that obtains the address book entries for you.
→ We support more platforms than anyone else. We were even the first ones to support Outlook.com just a few days after it was launched.

Which webmailers are supported?

The following platforms are currently supported:
→ AOL
→ Fastmail
→ GMX
→ GoogleMail
→ Hotmail (rebranded as Outlook.com)
→ Hushmail
→ Inbox.com
→ In.com
→ India
→ LinkedIn
→ Live
→ Lycos
→ Mail2World
→ Mail.com
→ Mail.ru
→ MSN (rebranded as Outlook.com)
→ Outlook.com
→ Plaxo
→ Rambler.ru
→ Rediffmail
→ RocketMail (acquired by Yahoo!)
→ Web.de
→ XING
→ Yahoo!
→ Yandex.ru.
Depending on which statistics you're following you'll see that with this impressive list we're covering 1.5 - 2 billion e-mail addresses that give you access to address books that probably contain all known e-mail addresses in the world.

Well, well... webmailer X is not in the above list!

That's cool. E-Mail us the name to info(at)jaide(dot)de and we'll look into it. If you're lucky you'll find it in the next update. If not we'll e-mail you back and tell you why not.

So how does it work?

Put the JAR file (and the dependencies that we provide) into the classpath of your application. One line of code will retrieve all address book entries for a particlar e-mail account. The input parameters to the call are the name of the platform, the username and the password of the account. That means that in your application you will have to ask the user for the name of the platform (GoogleMail? LinkedIn?) his username and password.
The data itself will be scraped from the address book entries, meaning: there is no OAuth and no developer API key needed. The library "just works" and you don't have to do any other set up than placing it in your classpath and use it.

Code, or it didn't happen

Alright, here you go:

    	
 /*
  * Load all of this user's contacts from his GoogleMail account
  */
 Result result = new AddressBookImporter().loadContacts(Platform.GOOGLEMAIL, "someone.special@googlemail.com", "secret");
 
 if (Status.OK == result.getStatus()) {
   List<AddressBookContact> contacts = result.getContacts(); 

   for (AddressBookContact contact : contacts) {
     String firstname = contact.getFirstname(); // ex: John
     String lastname = contact.getLastname();   // ex: Doe
     String email = contact.getEmail();         // ex: john.doe@company.com
     String company = contact.getCompany();     // ex: Company Inc.
   }
 }
 

How stable and reliable is it?

Occasionally a platform will not respond due to a networking problem or a planned maintenance. Despair not, this is normal and there's nothing anybody can do about it. This usually doesn't happen to the larger platforms such as GoogleMail or Yahoo! but the smaller ones (In.com, Hushmail etc.) will have outages here and there. As this only affects a small number of users this isn't much of a problem.
Then there will be platforms that change their code layout, meaning: we can't scrape the address book entries anymore. We usually notice this within 30 minutes and an updated version of our library will usually be available for you to download within 12 - 24 hours under your maintenance contract (or just let the software update itself automatically).
Other than that the library is very fast! Sometimes results are returned in less than 3 seconds and seldomly it takes longer than 7-8 seconds, depending on the platform. Here, again, the larger ones (GoogleMail, Yahoo! etc.) usually work well and the smaller ones tend to be a bit slower. Please keep in mind that those numbers also depend on your Internet connection.

Which fields are retrieved from the address books?

Currently we're returning a set of fields that all address books provide, which is the firstname, lastname, e-mail address and company name. In future updates this list will grow to all available fields.

How much does it cost?

Please see the pricing page for the current rates.

Can I test it first?

Sure! Head over to the download page and request your trial copy. It will run for 10 days. Not enough? E-Mail us at info(at)jaide(dot)de and we'll extend it for another 10 days. Still not enough? E-Mail us again. See the pattern here? ;-)

How does the maintenance work?

We constantly (meaning: every 30 minutes) monitor the platforms and test if our library still works. If it doesn't then we try to find out what's happening.
→ Is it a timeout? There's nothing we can do here, the target platform has a problem and we'll have to wait a few minutes... hours... sometimes days.
→ Are the test entries we're looking for not returned? In that case we'll fix the module and the update is automagically downloaded by the library within 60 minutes. You don't need to do anything, the library keeps itself up-to-date.
In any case - if there's an update available and you're on an active maintenance subscription you will also receive an e-mail with a download link to the latest version, in case you prefer to update it manually.
You'd like to check if any of the platforms are currently causing troubles? Check our status page, where our test suite is running every 30 minutes, and see if there are any issues.

What are the technical dependencies?

We're developing the library using Maven. The following libraries are currently needed and packaged along with your download, so you don't need to look for them yourself:
→ asm-1.0.2.jar
→ asm-3.3.1.jar
→ bsh-2.0b4.jar
→ commons-beanutils-1.8.3.jar
→ commons-codec-1.9.jar
→ commons-collections-3.2.1.jar
→ commons-digester-1.8.1.jar
→ commons-io-2.4.jar
→ commons-lang3-3.4.jar
→ commons-logging-1.2.jar
→ commons-validator-1.4.1.jar
→ cssparser-0.9.15.jar
→ htmlunit-2.16.jar
→ htmlunit-core-js-2.16.jar
→ httpclient-4.4.1.jar
→ httpcore-4.4.1.jar
→ httpmime-4.4.1.jar
→ jaide-license-1.3.jar
→ javax.servlet-api-3.1.0.jar
→ jcommander-1.48.jar
→ jetty-io-9.2.10.v20150310.jar
→ jetty-util-9.2.10.v20150310.jar
→ json-path-2.0.0.jar
→ json-simple-1.1.1.jar
→ json-smart-2.1.1.jar
→ jsoup-1.8.2.jar
→ log4j-1.2.17.jar
→ lombok-1.16.4.jar
→ nekohtml-1.9.22.jar
→ sac-1.3.jar
→ scribe-1.3.7.jar
→ serializer-2.7.1.jar
→ slf4j-api-1.7.10.jar
→ slm4j-signature-validator-1.3.jar
→ testng-6.9.4.jar
→ websocket-api-9.2.10.v20150310.jar
→ websocket-client-9.2.10.v20150310.jar
→ websocket-common-9.2.10.v20150310.jar
→ xalan-2.7.1.jar
→ xercesImpl-2.11.0.jar
→ xml-apis-1.4.01.jar

You're also using Maven and would like to know the Maven dependency coordinates? Active subscribers are granted access to our company Maven repository where you will also have access to SNAPSHOT releases.

Great. My question is not covered here.

It's all good, no worries. E-Mail us at info(at)jaide(dot)de or give us a call at +49-(0)40-228176760 (German business hours 9am - 6pm / GMT+1) and we'll try to help.