For All Calls

Host URLs

All requests should be preceded by the appropriate URL:

Development sandbox:



See authentication.

Data Format

Requests should specify their data format in the url:

<request URL>.json

So, the full URL for users/connect in production would be:

Currently, JSON is the only supported data type.

HTTP Status Codes

Val Desc
200 OK
204 No content – returned when attempting to search for user who has not yet been fully indexed
400 Bad request
401 Unauthorized – auth credentials missing or invalid
403 Forbidden


Network Names

Val Desc
facebook Facebook
twitter Twitter
foursquare Foursquare
linkedin LinkedIn
google Google (contacts only currently)
contacts Pseudo-network defined by user’s address book


Val Desc
friend Meaning of friendship is network dependent:
Facebook – person & user are friends
Twitter – user follows person
LinkedIn – person & user are contacts
Foursquare – friends
follower Person follows user

Communication Channels

Val Desc
dm Private, direct message (twitter only)
tweet Public tweet (twitter only)
wall_post Public post on wall
email Email

Document Types

Val Desc
status Status message
photo Photo
video Video
link Link
comment Comment
retweet Retweet (twitter only)


Dates are returned as 32-bit int values representing seconds since the epoch (January 1, 1970 UTC).