README for Python Implementation of LinkedIn API

LinkedIn API for Python
=======================
  This package provides a pure python interface for the LinkedIn Connection and Profile APIs.

  Author: `Ozgur Vatansever <ozgurvt@gmail.com>`

  LinkedIn (http://developer.linkedin.com) provides a service that let people bring their LinkedIn profiles
  and networks with them to your site or application via their OAuth based API. This library provides a simple
  architecture over a complicated LinkedIn OAuth based API to make it for python programmers easy to use.


INSTALLATION
============
  You have 2 options:

  1) Getting the code from repository:
     - svn co http...

  2) Getting the code from Google Code website of python-linkedin
     - wget bla bla..

  Enter the directory you've just downloaded, and execute the following command on shell to install the package:
  - sudo python setup.py install

  
KEYS
====

  In order to use it you have an 'application key' and 'application secret'.
  For debugging I am providing you those. You can use the following as api key and secret:

  KEY = wFNJekVpDCJtRPFX812pQsJee-gt0zO4X5XmG6wcfSOSlLocxodAXNMbl0_hw3Vl
  SECRET = daJDa6_8UcnGMw1yuq9TjoO_PMKukXMo8vEMo7Qv5J-G3SPgrAV0FqFCd0TNjQyG

QUICK USAGE FROM INTERPRETER
============================

  For testing the library using an interpreter, use the quick helper.
  
  from linkedin import helper
  
  api = helper.quick_api(KEY, SECRET)
  
  This will print a url to the screen. Go into this URL using a browser, after you login, the method will return with an api object you can now use.
  
  api.get_profile() etc...
  

BASIC USAGE
===========

  You can use "http://localhost" as the return url. Return URL is a url where LinkedIn redirects the user after he/she grants access to
  your application.
  """
  from linkedin import linkedin

  RETURN_URL = "http://localhost" 

  api = linkedin.LinkedIn(KEY, SECRET, RETURN_URL)

  result = api.request_token() # result can be True or False
  # if True, you can open your browser and copy the authorization url of LinkedIn.
  api.get_authorize_url() # open this url on your browser
  
  # When you grants access to the application, you will be redirected to the return url with the following query strings appended to your RETURN_URL:
  http://localhost/?oauth_token=0b27806e-feec-41d4-aac5-619ba43770f1&oauth_verifier=04874
  auth_verifier = 04874
  # After you get the verifier, you call the accessToken() method to get the access token.
  result = api.access_token("04874") # result can be True or False
  # if True, now you can fetch the methods that LinkedIn provides. 
 
  # To fetch your profile, simply call GetProfile method.
  profile = api.get_profile()
  profile.id # is your id (may be null)

  # if you know your public url, call the method above with your public url for more information
  profile = api.get_profile(member_id = None, url = "http://www.linkedin.com/in/ozgurv")
  profile.id # is your id
  profile.first_name
  profile.last_name
  profile.picture_url
  ... 
  ...

  # To fetch your connections, simply call 
  connections = api.get_connections() # connections is a list of profiles

  # To search people or company, you can use get_search() function
  peoples = api.get_search({'first-name':'Bill'})
  # Caution : you need to pass {'scope':'r_network'} to request_token() function to enable search. This part is customized by Philip Stewart.
  
LICENSE
=======
  This package is licensed under the GNU General Public License V2.

  To see the license, visit the following link:
   - http://www.gnu.org/licenses/gpl-2.0.txt