Blogs

Introducing the new guy and a new getting started tutorial!

Greetings awesome LinkedIn developers:

I would like to take this chance to introduce myself as the newest member on the developer relations team. My name is Steve Citron-Pousty and I joined the team in early November. My main areas of technical expertise are Java, mobile, spatial analysis and software, data munging, and consulting. I have been doing spatial related work since 1989, programming since 1997, and been a developer advocate since 2005. Hopefully you will see me around the forums and at shows helping you to understand the LinkedIn APIs and behind the scenes I will be advocating on your behalf to our internal team.

Given that my background is in the geospatial/location-based-services space I have been spending my ramp up time here “acting” like the developer new to the LinkedIn APIs. As part of this time, I have worked with the other developer advocates to help produce SHINY & NEW getting started documents for our REST API. They are intended for developers new to the LinkedIn REST API and walks you through the basic steps of working with the REST API. We start with making sure OAuth calls are working properly, then moving on to how to query the API, then write to the API (which is similar to updates and deletes), and then finally showing some basic debugging steps. The docs include code samples in 3 languages/platforms right now (Python, PHP, and Java). We hope to expand the list of languages as time permits.

We look forward to suggestions on this document, other languages you think we should add to the getting started document, and other things you think we could do help you with the LinkedIn APIs.

Thanks and happy coding...
Steve

P.S. you can follow me on twitter @TheSteve0, where I talk about everything from being a dad, to programming, to LinkedIn

LinkedIn Groups API: Professional Engagement Anytime, Anywhere

Millions of professionals use LinkedIn Groups to connect and share insights with like-minded professionals every day. With almost one million groups on LinkedIn, the top request we receive from group owners is to provide new ways to enable engagement within their communities. With that goal in mind, we’re announcing today that application developers can now take the rich content and engagement of LinkedIn Groups across the professional web using the new LinkedIn Groups API.
Explore the LinkedIn Groups API
Professional Engagement Anytime, Anywhere
Developers can bring the insights and powerful networking tools in LinkedIn Groups directly to professional applications. Whether building tools to help professionals keep in touch with their communities, enhancing organization websites, or creating mobile apps for special events, we think LinkedIn Groups are a key lever for developers to drive rich, professional conversation and networking within tools that our members use. The Groups API will enable applications to:

  • Get Group Discussions by Popularity and Recency
  • Get My Group Memberships
  • Get Suggested Groups
  • Join a Group
  • Post new group discussions
  • Comment, like and follow group discussions
  • Establish connections with other professionals

Powering Events with LinkedIn Groups
As an example of what developers can do with the Groups API, we are excited to have Microsoft debut the first large-scale implementation of the Groups API on their Microsoft Worldwide Partner Conference 2011 event website.


http://bit.ly/WPC11_chat This initiative is part of Microsoft’s larger social media efforts that reaches across multiple channels and beyond this event to ensure an ongoing dialogue with its partner community throughout the year. According to Microsoft, 53% of partners surveyed in a recent Microsoft Partner Network survey use LinkedIn. Integrating LinkedIn Groups to the event site will promote growth of this partner community, which relies heavily on business networking, as well as vibrant and relevant real-time conversation during the event. The Groups API will also allow the Microsoft Partner Network to take advantage of content longevity, as community-generated content will continue to live on inside the LinkedIn Group beyond the event time-frame.  Imagine the benefit to attendees as they share comments about event sessions and activities for other attendees to consume in real-time, and establish long-lasting professional connections with others in their community. Hear more about how Microsoft is using Groups at their online forum chat today.

Ready, Set, Code!

We know that it is important to make our API capabilities available to developers in the technologies that they are comfortable with. Thanks to the flexibility of our platform, our new Groups API is accessible via our easy to use JavaScript API as well as our language agnostic RESTful APIs.

Explore the LinkedIn Groups API

Stay tuned for even more exciting news from the LinkedIn Platform team this summer!  Please don’t be shy to tell us what you think — either by commenting or participating in the forums at developer.linkedin.com.

Bringing Companies and Jobs APIs to the Professional Web

Since we launched our Open Platform in late 2009, LinkedIn’s Developer Network has grown to over 25,000 registered developers making 2 Billion monthly calls, bringing the power of LinkedIn’s professional graph to applications and websites everywhere. We are excited to announce new platform capabilities that will enable app developers to bring even more LinkedIn insights to our members, through their apps.
Explore LinkedIn's Powerful APIs

Rich new Company and Jobs APIs
Today, we’re launching a set of powerful APIs to access the rich information about Companies and Jobs on LinkedIn.  This will help developers bring company content and job opportunities to our members, wherever they want to see them.


LinkedIn’s company pages contain rich profile and product data for more than 2 million small and large businesses. Imagine an email application allowing you to lookup the company that the sender works for, with a rich display of company information, further linking to people who you know at that company.  Think of an innovative mobile app that enables you to search across company profiles by industry, location, size, and more.  Our new Company APIs give developers the ability to: ·   Retrieve detailed Company content·   Search across companies with rich facets·   Get Products and Recommendations for any Company·   Follow Companies on LinkedIn·   Get Personalized Suggestions for Companies to Follow Jobs on LinkedIn provide opportunities for professionals to take a step on their career ladder. The new Jobs APIs enable LinkedIn Job postings to reach desktop apps, websites, and career pages.  Now every company’s career site can feature their LinkedIn jobs and enable users to search by location, job function, industry, and most importantly access their relationship to the company employees and hiring manager through our professional graph. Our new Jobs APIs give developers the ability to: ·   Retrieve detailed Job content·   Search across LinkedIn’s Jobs with rich facets·   Bookmark Jobs to a user’s LinkedIn account·   Get Personalized Suggestions for Jobs Javascript or REST – Take your PickWe know that it is important to make our API capabilities available to developers in the technologies that they are comfortable with. Thanks to the flexibility of our platform, our new Companies and Jobs APIs are accessible via our easy to use JavaScript API as well as our language agnostic REST API.


Explore LinkedIn's Powerful APIs


Stay tuned — we have more exciting things planned this summer.  Please don’t be shy to tell us what you think — either by commenting or participating in the forums at developer.linkedin.com.

Creating an Application using the LinkedIn Javascript API

As many of you know, we're previewing a new Javascript based API here at LinkedIn.  This makes it much easier to develop web applications for LinkedIn, abstracting away most of the OAuth authentication and providing convenience methods for many common tasks.  If you haven't taken a look, I encourage you to visit the JS API landing page to see what's available.

Friday was Hackday here at LinkedIn, and I made an internal presentation to our developers to walk them through the steps of creating an application using our JS API.  I also created a blog post on my site with the same information, and I want to encourage you to read through the post to see how easy it is to get started with this new platform.

Here's the application the tutorial builds. You can see source code for the completed application at http://www.princesspolymath.com/StreaminSmall/Step3.html.  The tutorial should give you not only the information you need to build this application, but enough tools in your belt to create the applications you want to build.

New Console Tools

LinkedIn is strongly committed to doing everything we can to make you, our developers, successful.  To that end, we're launching a few consoles to make it easier to answer questions, debug, and explore the API.

The first console is the OAuth Test Console.  This console allows you to input your OAuth credentials and API call variables and see the correct OAuth parameters - and then make that call directly from the console to see the output.  Since many authentication issues arise from signature mismatches, it's quite useful to be able to see the correct signature to confirm if there's something going awry with the signature you're creating.  You can set all of the parameters to match the ones your application is using and determine if it's an exact match.  Additionally, this is a great tool to just explore the API - figure out exactly the call you want to get the information you're looking for, with quick iterations to check the output.  To make this tool even handier, we've added HTML5 local browser storage for browsers which support it - so you don't have to copy and paste your application and member credentials each time you enter the console.

The second console is the REST Console, which comes thanks to our friends at apigee. This is a quick way to browse through our APIs. It uses its own credentials, so once you've signed in as a user, you simply choose which calls you want to make and see how they work. Nothing could be more simple to let you explore the API and see what it offers. Along with the pre-set options in the navigation panel, you can also input your own URL to fetch resources which aren't included in the menu. If this tool looks familiar, it used to live on the apigee site, but, to make it even more conveinent, it's now part of our site, too!

We hope these consoles will serve you well in your development cycles.  Please let us know how we can make them better, or if you have ideas for additional tools.  As always, we look forward to seeing what you can create.  Have fun!

Tools and Libraries

One of the main goals we have for our documentation is to make it easy for developers to get starting writing their applications right away.  The new OAuth documentation should help, but every developer has a favorite language - or one they need to use for a particular project - and it's frustrating to feel like you can't find pointers to what you need to get going. As it turns out, several community members have made LinkedIn libraries for specific programming languages.  All we need is a way for you to find the one you need quickly and easily.

I've put together a Libraries and Tools page with pointers to the existing libraries, tools, tutorials and examples.  This is by no means an exhaustive list, but we currently have tutorials or libraries for AS3, C#, C++, Java, Javascript, Objective C, Perl, PHP, Python and Ruby.  I'll be adding new resources to the page frequently, and would love pointers from the forum members when you find something you particularly like (or if you have a comment about your experience with one of the resources listed on the page).

Comments, questions and suggestions are, as always, welcome.

OAuth Documentation Update

First off, I'd like to introduce myself.  I'm Kirsten Jones, the newest Developer Advocate here at LinkedIn.  The Developer Relations team is working hard to help you, our developers, achieve success using the LinkedIn API, including writing and organizing our documentation to make it easy to find what you need. To accomplish this, I'm going to add more examples and tutorials to the documentation and work to make the information clearer and more accessible.

That having been said, the first thing I tried to do when I got here was get OAuth working so I could start playing with the API.  And the first thing I thought was "Man, this documentation is kind of hard to follow."  Since I was already familiar with OAuth, it seemed to me it shouldn't have been that hard, even if OAuth isn't always a piece of cake to use. Since many developers don't already have OAuth experience, I decided to start by updating that documentation, because if you can't get starting using the LinkedIn APIs, you'll never get to build any cool applications using them.

To make the OAuth documentation more accessible, I split it into several pieces, so that you only need to look at the ones that are meaningful to you.

At the top level, Using OAuth with the LinkedIn APIs gets you started with an overview of what OAuth is and why we use it.  If you're not already familiar with OAuth, the OAuth Overview will help you understand how it works.

If you're already familiar with OAuth, you can skip directly to LinkedIn's OAuth Details. This page also documents how fields in your Application Details affect the OAuth flow, such as how to set a custom image for your application in the authorization window.

Last, I wrote a walkthrough and sample code for Getting an OAuth Token and Making an API Call with an OAuth Token.  The examples given are in python, but we're gathering together examples in other languages - and in fact would love any example code that our developers want to share. The more examples we can provide, the merrier - after all, as Adam has said before, we love all languages here!

I'll see you all on the forums, and let you know as we make more progress on our documentation.  I'm looking forward to working with all of you and seeing what amazing things you build!

New profile fields are here!

At LinkedIn, we like to ring in the new year with a bang. That's why I'm happy to announce that we've extended the LinkedIn API to include more fields of rich profile data for integration with applications using the LinkedIn Platform.

LinkedIn's Profile API now includes additional profile fields for accessing users' publications, patents, skills, certifications, and language fluencies, as documented here.  You can access this data by applying advanced field selectors using our API (for example, http://api.linkedin.com/v1/people/~:(id, first-name, last-name, skills)).

Let's take a look at each of the new sections that will be available to access for users who have listed these details on their profiles!

Publications
Find the prolific authors and published researchers in your network.  The publications section contains data pertaining to the user's body of published work, including title, publication date, publisher, co-authors, and an abstract.

http://api.linkedin.com/v1/people/~/publications

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<publications total="1">
  <publication>
    <id>31</id>
    <title>PHP Cookbook</title>
    <date>
      <year>2006</year>
      <month>8</month>
      <day>1</day>
    </date>
  </publication>
</publications>

Languages
Ever wonder who in your network speaks Russian?  Do any of your connections know three or more languages fluently?  Now you can determine the languages spoken by LinkedIn members and their proficiency levels in your application with the languages selector.

http://api.linkedin.com/v1/people/~/languages

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<languages total="2">
  <language>
    <id>70</id>
    <language>
      <name>English</name>
    </language>
  </language>
  <language>
    <id>72</id>
    <language>
      <name>Klingon</name>
    </language>
  </language>
</languages>

Skills
A listing of skills with proficiency levels and years of experience will give you information about a user's areas of expertise and proficiencies.  Discover the strengths of your network!  For example, need to find the Java experts?  Want to visualize which of your connections can help with viral marketing?  Look no further than the skills section.

http://api.linkedin.com/v1/people/~/skills

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<skills total="1">
  <skill>
    <id>38</id>
    <skill>
      <name>Union negotiations</name>
    </skill>
  </skill>
</skills>

Certifications
Access the certifications, licensure, and clearances that users have attained by selecting the certifications field.

http://api.linkedin.com/v1/people/~/certifications
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<certifications total="1">
  <certification>
    <id>32</id>
    <name>Series 7 Exam</name>
  </certification>
</certifications>

Patents
Is there an inventor in your midst?  For users with patents and patent applications listed on their profiles, the patents field will give your application access to information on their inventions.  Access links to issued and pending patents along with listed co-inventors, and see how the seeds of innovation are sprouting in your own network!

http://api.linkedin.com/v1/people/~/patents

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<patents total="1">
  <patent>
    <id>51</id>
    <title>BID SYSTEM FOR PRESENTATION OF DATA ITEMS</title>
    <date>
      <year>2008</year>
      <month>7</month>
      <day>23</day>
    </date>
  </patent>
</patents>

These five sections are the first of many more that we will be rolling out on the LinkedIn site as well as our developer API.  We look forward to seeing LinkedIn Platform integrations that help bring the richness of LinkedIn profiles to the places you work.

As a reminder, fields returned in a user's profile are subject to LinkedIn's data visibility rules and the member's privacy settings. In certain scenarios, you may receive only the following fields for a user:

<person><id>private</id><last-name>private</last-name></person>

Read more about the specific API behavior here, and make sure your application is ready to handle these situations.

Best wishes in the new year!

Connect with us at LeWeb

To celebrate the one year anniversary of the LinkedIn Developer Network, we're returning to Le Web. This event is packed with leading business people and developers from companies small and large. They're all converging on Paris to discuss the future of the Internet in 2011 and beyond.

We're hosting a workshop on the LinkedIn Platform.

Learn how the LinkedIn Platform is spreading professional identity across the web and how you can take advantage. Increase customer relevance and engagement with your site or application by incorporating unique LinkedIn features and content, including over 85 million profiles, professional graphs, and updates. Are you [in]?

Find us at:

  • Thursday, December 9th from 2:30 pm to 3:30 CET
  • Room #3

Or catch us anytime at the show. If you want to meet up, drop me a note or write a comment.

-adam

API Test Console for LinkedIn

Hi Developers!

I'm new here on the LinkedIn Platform Product team, and wanted to say hello to all of you who are doing great things with LinkedIn's APIs.

As you explore our API's capabilities and feature set, take a look at the LinkedIn API Console that our friends over at Apigee just released. This console is definitely a huge help in trying out LinkedIn API features and debugging your app, without the overhead of OAuth.

Here is a video of how to use the console - check it out!

Keep talking to us - we love to hear from you, and happy coding!

Madhu

Pages