English | Site Directory

Social Graph API

Edge Types

All edge types from all supported formats are mapped onto their closest XFN equivalent. Consult the XFN 1.1 documentation for details.

In summary, the XFN relation types are:

  • Identity:
    • me: a claim that the referenced URL is yours
  • Those that indicate a relation to another person:
    • contact
    • acquaintance
    • friend
    • met
    • co-worker
    • colleague
    • co-resident
    • neighbor
    • child
    • parent
    • sibling
    • spouse
    • kin
    • muse
    • crush
    • date
    • sweetheart

Other source of me links

Besides explicit XFN links, here are some of the other formats which generate a me edge:

  • Fields in FOAF, such as:
    • weblog
    • homepage
    • openid
    • mbox_sha1sum, with the resulting internal target node of the format:
      sgn://mboxsha1/?pk=4caa1d6f6203d21705a00a7aca86203e82a9cf7a
  • OpenID delegation <link> tags, both openid.delegate and openid2.local_id.
  • FOAF declaration <link> tags. (i.e. if http://example.com/ has a <link> to http://example.com/my-foaf.rdf, then a me edge is created from http://example.com/ to http://example.com/my-foaf.rdf)
  • mailto: queries. When querying on an email address, a directed edge of type me from mailto:foo@bar.com to sgn://mboxsha1/?pk=xxxxx... is temporarily assumed, but not stored.

Mapping FOAF's knows field

By default, any knows relation in a FOAF file is mapped to the XFN value of contact. However, in cases where a site publishes both XFN and FOAF, with a single XFN edge type, the FOAF knows mapping will be the site's XFN edge type used.

Back to top