Social Graph API Documentation

The Google Social Graph API lets you access the public relations declared on the Internet, from formats such as XFN and FOAF.

Contents

1. Audience
2. Usage policy
3. Introduction
4. URL format
5. Methods

Audience

This document is intended for programmers who want to access the global, public social graph either from a webpage or from a server. It provides an introduction to using the API and reference material on the available parameters.

Back to top

Usage Policy

Use of the Social Graph API is subject to a query limit of 50,000 queries per user per day. If you go over this 24-hour limit, the Social Graph API may stop working for you temporarily. If you continue to exceed this limit, your access to the Social Graph API may be blocked. Please contact us (see the FAQ) if you would like this limit raised for your application.

Back to top

Introduction

The Google Social Graph API returns a JSON data stucture in response to a URL. You may optionally request a JSONP callback, to use the data inside a client-side JavaScript application. Otherwise, JSON parsers are available for most languages. Depending on a series of options, you may request different types of information from the social graph.

Back to top

URL format

Google Social Graph API URLs are of the following format:

http://socialgraph.apis.google.com/<method_name>?<parameter 1>&<parameter 2>&<parameter n>

Back to top

Methods

The following methods are available:

• lookup: low-level access to the graph.
• otherme: given one or more of a person's identifiers (e.g. URLs), return other identifiers for that person.
• testparse: test your site's XFN or FOAF to see what the Social Graph API's parsers find in it

Back to top