Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/esteve/python-linkedin


https://github.com/esteve/python-linkedin

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

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 `

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

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