Marketing API Version

Ad Account Matched Search Applications

Reading

Search for applications from google store, apple store and advertisable applications that match search input.

Example

Graph API Explorer
GET /v2.11/{ad-account-id}/matched_search_applications HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{ad-account-id}/matched_search_applications',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{ad-account-id}/matched_search_applications",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{ad-account-id}/matched_search_applications",
    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:@"/{ad-account-id}/matched_search_applications"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Parameters

NameDescription
app_store
enum {AMAZON_APP_STORE, GOOGLE_PLAY, ITUNES, ITUNES_IPAD, FB_CANVAS, FB_GAMEROOM, WINDOWS_STORE, FB_ANDROID_STORE, WINDOWS_10_STORE, ROKU_STORE, INSTANT_GAME, DOES_NOT_EXIST}

Specify app store for applications that will be searched

Required
app_store_country
string
Default value: US

Specify app store country for applications that will be searched

business_id
Business ID ID

Specify Business ID for applications under a specific business

query_term
string

Input search term that will be used to search applications

Required

Fields

Reading from this edge will return a JSON formatted result:

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

data

A list of AdAccountMatchedSearchApplicationsEdgeData nodes.

paging

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

Validation Rules

ErrorDescription
100Invalid parameter
200Permissions error

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.