Graph API Version

Audience Insights Query Result

Reading

Results of an audience insights query.

Examples

Graph API Explorer
GET v2.10/...?fields={fieldname_of_type_AudienceInsightsQueryResult} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '...?fields={fieldname_of_type_AudienceInsightsQueryResult}'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "...?fields={fieldname_of_type_AudienceInsightsQueryResult}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "...?fields={fieldname_of_type_AudienceInsightsQueryResult}",
    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:@"...?fields={fieldname_of_type_AudienceInsightsQueryResult}"
                                      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

age_bracket

enum

Age bracket

buyer_of_product

enum

Buyer of product

city

integer

City

country

string

Country

credit_card

enum

Credit card

day_posted

string

Date

device

enum

Device

education_level

enum {unknown, high_school, college, grad_school}

Education level

error

string

Error

gender

enum

Gender

home_ownership

enum

Home ownership

home_size

enum

Home size

home_type

enum

Home type

home_value

enum

Home value

household_composition

enum

Household composition

in_market_for_a_vehicle

enum

In market for a vehicle

income

enum

Income

industry

enum

Industry

interest

numeric string

Interest

language

string

Language

life_event

enum

Life event

lifestyle

enum

Life style

metric

enum

Metric

multicultural_affinity

enum

Multicultural affinity

net_worth

enum

Net worth

num_ad_click

integer

Number of ad clicks

office_type

enum

Office type

page

string

Page

parental_situation

enum

Parental situation

payment_preference

enum

Preferred payment method

political_belief

enum

Political belief

promotion_redeemed

integer

Number of promotion redeemed

range

AudiRange

Range

ratio

float

Ratio

region

integer

Region

relationship_status

enum {single, relationship, engaged, married, unknown}

Relationship status

retail_spend

enum

Retail spend

sentiment

enum

Sentiment

study_rule

numeric string

Study rule

time_posted

enum

Time posted

values

list<AudienceInsightsKeyValue>

List of value for top metrics

Edges

No edges

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.