Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
    • Graph API
    • FQL
    • Open Graph
    • Dialogs
    • Chat
    • Internationalization
    • Ads
  • Games
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • JavaScript
  • PHP
  • More SDKs
  • Best Practices
    • Batch Requests
    • Using ETags
  • Reference
    • Cost Per Action (CPA) Ads
    • Currencies
    • Introduction to Action Spec
    • Introduction to Sponsored Stories
    • Mobile App Install Ads
    • Optimized CPM
    • Real Time Bidded Exchange protocol
    • Sponsored Results
    • Thrift file for Real Time Bidded Exchange protocol
  • Specs
    • Conversion Specs
    • Creative Specs
    • Defining Action Specs
    • Targeting Specs
    • Tracking Specs
  • Advanced Targeting
    • Action Spec Targeting
    • Conversion pixels
    • Custom Audience targeting
    • Topic Targeting
    • ZIP Code Targeting
  • Queries
    • Action Estimate
    • Action Spec Ad Previews
    • Ad Statistics
    • Autocomplete Data
    • Broad Target Categories
    • Connection Objects
    • Conversion Stats
    • Keyword Stats
    • Partner Categories
    • Reach estimate
    • Targeting Description
  • Objects
    • Ad account
    • Ad account group
    • Ad campaign
    • Ad creative
    • Ad group
    • Ad image
    • Ad user

Action Estimate

Facebook APIs › Ads › Action Estimate

The Action Estimate of a given action spec is an approximation of the number of actions this action_spec defines given current activity on Facebook. It also includes the number of actors who are making those actions and the number of friends those actors have.

Note : When querying an action estimate for a newly created Open Graph object there can be a delay of a few hours to a day before the Action Estimate service has enough data to return a non-zero action estimate result.

Query Result Fields

Name Description Permissions Returns
actions The estimated number of times the action defined by this action spec is being performed. ads_management long
actors The estimated number of people who are performing this action ads_management long
friends The estimated number of friends of the people who are performing this action. ads_management long

Query the action estimate of a action spec

To query the action estimate of an action spec, pass in the action spec as a query-string parameter to the actionestimate connection of the Ad account object:

act_AccountID/actionestimate?action_spec=_____

Note that an action_spec is required for accessing /{account-id}/actionestimate.

Below is an example of a response:

{
   "data": {
      "actions": 10271,
      "actors": 1202,
      "friends": 282865
   }
}
Updated about 9 months ago
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy