Graph API Version

Crisis Listing

Reading

This node represents a post made in the Community Help section of Safety Check, where people can offer or request resources after a natural disaster. These entries have well-defined positions and structured data in order to plot them on a map and facilitate matching.

Examples

Graph API Explorer
GET /v2.9/{crisis-listing-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{crisis-listing-id}'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "/{crisis-listing-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{crisis-listing-id}",
    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:@"/{crisis-listing-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription

id

numeric string

The id of the object

creation_time

datetime

Time when the post was created

for_num_people

unsigned integer

The number of people this request is for, omitted from certain categories (like pet supplies)

latitude

float

The approximate latitude GPS location of this listing; the real location is not provided due to privacy concerns. Useful for plotting on a map

listing_category

CrisisListingCategory

The category that this offer or request is for

listing_type

enum

The listing type represents whether this post is requesting help or offering help; however, it also has two other states, a "closed request" and a "closed offer" which represents the user closed this post out. Posts with the latter types should no longer be shown on the map

longitude

float

The approximate longitude GPS location of this listing; the real location is not provided due to privacy concerns. Useful for plotting on a map

message

TextWithEntities

An associated message with the offer or request, optional

permalink_uri

string

The uri of this Community Help post, where users can like, comment on, or share the post

update_time

datetime

Time when the post was last updated; default value is when the post was created

Edges

EdgeDescription

comments

the comments associated with this listing

likes

the likes associated with this listing (a subset of reactions)

reactions

the reactions of this listing (including like, angry, wow, sad, etc)

Creating

You can't perform this operation on this endpoint.

You may perform a POST request to the following edge from this node:

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.