Contacts Importer @ Address Book Grabber
(PHP, .NET, Java, Ruby, ColdFusion)
How it works...
The best way to generate genuine traffic is by referrals, and our unique importer script helps you do just that.
Your visitors simply provide their email address and password and our script fetches a list of contacts into an array/list. Your application can then choose to send emails to these contacts, store them in your database, etc.
Easy Integration for PHP, .NET, Java, Ruby & ColdFusion (and others)
Get up and running in just 5 minutes! See how. Available for PHP, .NET, Java, Ruby and ColdFusion. Well-thought architecture ensures you are able support new webmails without changing a single line of your code!
The PHP version now supports PhpFox 1.5 & 1.6 !
 Largest Webmail Support
We support all major webmail systems, and are usually the first to support new systems. Our list of supported webmails is growing by the day. See our full list here. Support for new webmail is provided free of charge in our periodic updates.
See what our clients are saying.
Webmails supported
- Hotmail
- MSN Mail
- Hotmail Live
- Yahoo mail
- Gmail
- AOL
- Lycos (including international Lycos.co.uk)
- MobileMe (previously .Mac)
- Mail.com (and all its domain variants)
- FastMail.FM (and all its domain variants)
- Rediffmail
- Indiatimes
- GMX
- LinkedIn
- IcqMail
- Web.de
- MyNet.com
- Mail.ru
- Freenet.de
- Libero.it
- Rambler.ru
- Yandex.ru
- Onet.pl
- Interia.pl
- Wp.pl
- T-Online
- Plaxo (new!)
- Outlook
- Outlook Express
- Thunderbird
See Also...
Features & Benefits
- Uses Webmail APIs
We utilize official webmail APIs where available, ensuring functionality does not break even if user interface of webmail changes.
- Secure
The only traffic going through the library is that between your server and the web mail servers. We do not intercept or capture any of your traffic.
- Even the big guys use our libraries
Some of the large social networks that you know are even using us. That speaks volumes by itself.
- Support for all major webmails
We support all major webmails, and are usually the first to support new systems. Support for new webmails is bundled with updates, free of charge!
- Support for Outlook, Outlook Express and Mozilla Thunderbird!
We also include importers for Outlook, Outlook Express and Mozilla Thunderbird for free (with the all webmail package only) !
- Available for PHP (4 & 5), .NET framework, Java, Ruby and ColdFusion
It's your choice, and its PHP 5 compatible as well.
- Easy to use and integrate.
Get up and running in just 5 minutes! PhpFox support is built-in!
- Sound architecture
Our codes are designed based on OOP principles, with detailed error messages enabling you to know the difference between server failures, or bad user name / password.
- Multiple Local IP Address Support
If your server runs on multiple IP addresses, our code allows you to dynamically bind to different IP addresses on your local network (PHP and Java only for now)
- Documentation & sample code provided
Manual and sample code is provided to allow you to have a jumpstart at integrating
- Supports international domain extensions (.co.uk, .com.au, etc) and unicode (non-English) names
We support international domain names (yahoo.co.uk, hotmail.co.uk, etc) and even extraction of non-English names in your address book.
- Fast, optimized & network-efficient code.
Return results quickly, and reduce your server bandwidth usage. We make use of compressed HTTP and Keep-Alives to give you the fastest response possible.
- And not forgetting
- Proven technology, ideal for web hosted sites
- Our commitment to excellent support
- Frequent free/cheap updates !
System Requirements
- For .NET version
- .NET framework 2.0
- ASP.NET Web Application configured to run in full trust, or granted SocketPermission if your application is running in medium/partial trust. Visit the following links for more information and steps for granting SocketPermission.
- For PHP version
- PHP 4.3 or higher
- cURL 7.1 or higher (7.10 or higher required for compression support)
- Download this PHP script to determine if your server supports the Address Book Importer!
- For Java version
- For Ruby version
- Ruby 1.8.4 or higher
- Json, htmlentities. To install, issue the following command
- gem install htmlentities
- Either "gem install json" or "gem install json_pure". Try using the pure Ruby JSON library if native version is giving you problems.
- For ColdFusion
- ColdFusion MX. No external library/modules required.
- Tested on ColdFusion MX 7 & 8
For PHP users: Is my PHP server compatible?
- Download this PHP script to determine if your server supports the Address Book Importer!
What is included?
- Component library (DLL for .NET version, PHP scripts for PHP, .JAR files for Java, RB scripts for Ruby)
- Sample codes
- Documentation/Usage manual
Licensing & Terms of Use
- No refunds provided for all purchases.
- You may use this product in your own website, but you may not embed/resell the above products, or any parts derived out of it in any other free or commercial products.
- Product is licensed on per server website basis. If you are developing websites for your customers, then you will need to obtain one license for each of your customer's website instances. For example, if you have 2 load-balanced server serving one website, you will need 2 licenses for the site.
- License also includes use for development purposes in unlimited number of machines within the organization.
- Free update duration is for 6 months (180 days) from the date of purchase.
Sample Codes
PHP
<?php
include_once("abimporter/abi.php");
$obj = new AddressBookImporter;
$res = $obj->fetchContacts($email,$pass);
if ($res==_ABI_AUTHENTICATION_FAILED) {
echo 'Bad user name or password';
}
else if ($res==_ABI_FAILED) {
echo 'Server error';
}
else if ($res==_ABI_UNSUPPORTED) {
echo 'Unsupported webmail';
}
else {
foreach ($res as $contact) {
$name = $contact->name;
$email = $contact->email;
echo htmlentities($name).' <'.htmlentities($email).'><br>';
}
}
?>
.NET
using System;
using System.Collections.Generic;
using System.Text;
using Octazen.AddressBook;
using Octazen.Http;
using Octazen.Debug;
namespace AbiTester
{
class Program
{
static void Main(string[] args)
{
try
{
string email = "myaccount@gmail.com";
string pass = "mypassword";
List<Contact> cl =
SimpleAddressBookImporter.FetchContacts(email, pass);
foreach (Contact contact in cl)
Console.WriteLine(contact.Name+ " <" + contact.Email + ">");
}
catch (UnsupportedAddressBookException e)
{
Console.WriteLine("Unsupported webmail");
}
catch (AddressBookAuthenticationException e)
{
Console.WriteLine("Authentication failed - " + e.Message);
}
catch (Exception e)
{
Console.WriteLine("Server error - " + e.Message);
Console.WriteLine(e.StackTrace);
}
}
}
}
Java
import java.io.IOException;
import java.util.Iterator;
import java.util.List;
import octazen.addressbook.AddressBookAuthenticationException;
import octazen.addressbook.AddressBookException;
import octazen.addressbook.Contact;
import octazen.addressbook.SimpleAddressBookImporter;
import octazen.addressbook.UnexpectedFormatException;
import octazen.addressbook.UnsupportedAddressBookException;
import octazen.http.HttpException;
public class TestImporter {
public static void main(String[] args) {
try {
String email = "myaccount@gmail.com";
String pass = "mypassword";
List<Contact> list =
SimpleAddressBookImporter.fetchContacts(email, pass);
Iterator<Contact> it = list.iterator();
while (it.hasNext()) {
Contact contact = (Contact) it.next();
System.out.println(contact.getName()
+ " <"+ contact.getEmail() + ">");
}
} catch (AddressBookAuthenticationException e) {
System.err.println("Sorry, bad user name or password");
} catch (UnexpectedFormatException e) {
System.err.println("Server error. Received unexpected content");
} catch (UnsupportedAddressBookException e) {
System.err.println("Unsupported webmail");
} catch (AddressBookException e) {
System.err.println("Unsupported webmail / internal error");
} catch (IOException e) {
System.err.println("IO exception:" + e.getMessage());
} catch (HttpException e) {
System.err.println("General http error");}
}
}
Ruby
# Sample code demonstrating use of Ruby importer
require 'abimporter/abimporter'
require 'abimporter/yahoo'
require 'abimporter/gmail'
require 'abimporter/hotmail'
require 'abimporter/aol'
obj = Octazen::GmailImporter.new
#obj = Octazen::YahooImporter.new
#obj = Octazen::HotmailImporter.new
#obj = Octazen::AolImporter.new
begin
al = obj.fetch_contacts("myemail@domain.com","mypassword")
al.each do |contact|
email = contact.email
name = contact.name
puts "Email=#{email}, Name=#{name}"
end
rescue Octazen::AuthenticationError => err
puts "Bad user name or password"
rescue Octazen::UnexpectedFormatError => err
puts "Server returned unexpected data"
rescue Octazen::CaptchaError => err
puts "Captcha challenge issued by server"
rescue Octazen::AddressBookError => err
puts "General error"
end
|
