Graph API Version

Page Media Fingerprints

Reading

Media fingerprints from this page

Graph API Explorer
GET /v2.9/{page-id}/media_fingerprints HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{page-id}/media_fingerprints'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "/{page-id}/media_fingerprints",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/media_fingerprints",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/media_fingerprints"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Parameters

This endpoint doesn't have any parameters.

Fields

Reading from this edge will return a JSON formatted result:

{ "data": [], "paging": {} }

data

A list of MediaFingerprint nodes.

paging

For more details about pagination, see the Graph API guide.

Validation Rules

ErrorDescription
100Invalid parameter

Creating

You can make a POST request to media_fingerprints edge from the following paths:
When posting to this edge, a MediaFingerprint will be created.

Parameters

NameDescription
fingerprint_content_type
enum {SONGTRACK, EPISODE, OTHER, MOVIE, AM_SONGTRACK}

Media fingerprint content type

Required
metadata
array

The fingerprint metadata, for example: metadata={'episode':'newEpisodeVal','season':'newSeasonVal'}

Required
album
string

Album name of a songtrack. This is a required metadata field for SONGTRACK content type.

artist
string

Artist name of a songtrack. This is a required metadata field for SONGTRACK content type.

episode
string

Episode name of an episode. This is a required metadata field for EPISODE content type.

season
string

Season name of an episode. This is a required metadata field for EPISODE content type.

description
string

Description of fingerprint. This is a required metadata field for MOVIE and OTHER content type.

source
string

The location of the media file, e.g /home/media/sample.mp4

Required
title
string

Media title

Required
universal_content_id
string

A unique code user can use to manage fingerprint. For example: International Standard Recording Code for songtracks. This is for your own use; Facebook will not use this data.

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: numeric string,
}

Validation Rules

ErrorDescription
100Invalid parameter

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.