Ad Account Suggested Ads

Updated: Oct 11, 2023

Reading

AdAccountSuggestedAds

Example

Select language

GET /v25.0/{ad-account-id}/suggested_ads HTTP/1.1
Host: graph.facebook.com

Try it in Graph API Explorer

If you want to learn how to use the Graph API, read our Using Graph API guide

Parameters

Parameter	Description
`application_id` numeric string	application_id
`cms_id` numeric string	cms_id
`countries` array<string>	countries
`limit` int64	Default value: `20` limit
`objective` string	objective
`optimization_event` enum {JOB_ALERT_SUBSCRIBE, JOB_APPLICATION_CREATE, JOB_APPLICATION_FORM_IMPRESSION, JOB_BROWSER_IMPRESSION, JOB_OPENING_DETAIL_VIEW_IMPRESSION, ACTIVATE_APP, COMPLETE_REGISTRATION, CONTENT_VIEW, ONSITE_APP_CONTENT_VIEW, ONSITE_WEB_CONTENT_VIEW, ONSITE_WEB_APP_CONTENT_VIEW, SEARCH, RATE, TUTORIAL_COMPLETION, CONTACT, CUSTOMIZE_PRODUCT, DONATE, FIND_LOCATION, SCHEDULE, START_TRIAL, SUBMIT_APPLICATION, SUBSCRIBE, RECURRING_SUBSCRIPTION_PAYMENT, CANCEL_SUBSCRIPTION, VISIT_LOCATION, AD_CLICK, AD_IMPRESSION, UPDATE_PLTV, APPEND_VALUE, ADD_TO_CART, ONSITE_APP_ADD_TO_CART, ONSITE_WEB_ADD_TO_CART, ONSITE_WEB_APP_ADD_TO_CART, ADD_TO_WISHLIST, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, PURCHASE, APPEND_CLICK_ATTRIBUTION, ONSITE_APP_PURCHASE, ONSITE_WEB_PURCHASE, ONSITE_WEB_APP_PURCHASE, MESSAGE_TO_BUY, LEAD, LEAD_CUSTOM_EVENT, LEAD_SUBMITTED, ONSITE_WEB_LEAD, PDP_CLICK_TO_OFFSITE, PDP_CLICK_VIEW_IN_CART, PDP_CLICK_TO_CHECKOUT, ORDER_CREATION, CART_IMPRESSION, SHOP_MID_FUNNEL, LEVEL_ACHIEVED, ACHIEVEMENT_UNLOCKED, SPENT_CREDITS, FLOW_COMPLETE, SERVICE_BOOKING_REQUEST, INSTAGRAM_PROFILE_FOLLOW, INSTAGRAM_PROFILE_VIEW, PROFILE_FOLLOW, PROFILE_VIEW, INSTAGRAM_AD_FOLLOW, INSTAGRAM_AD_FOLLOW_QUALITY_SCORE, INSTAGRAM_FOLLOW_QUALITY_SCORE, PROFILE_FOLLOW_QUALITY_SCORE, INSTAGRAM_LEAD_GEN_LAW, UPCOMING_EVENT_REMINDER_SET, UPCOMING_EVENT_REMINDER_UNSET, UPCOMING_EVENT_NOTIFICATION_CLICK, UPCOMING_EVENT_POST_NOTIFICATION_LINK_CLICK, UPCOMING_EVENT_POST_NOTIFICATION_UAS_TAP, IG_RECONSIDERATION_ENTRY_POINT_CLICK, MESSAGING_ACCEPT, MESSAGING_BLOCK, MESSAGING_DELETE_THREAD, MESSAGING_FRX_FEEDBACK, MESSAGING_SCAM_PROACTIVE_WARNING_LEARN_MORE, MESSAGING_SCAM_PROACTIVE_WARNING_LEARN_MORE_EXPERIMENTAL, MESSAGING_IN_THREAD_FEEDBACK_SATISFIED, MESSAGING_IN_THREAD_FEEDBACK_DISSATISFIED, MESSAGING_IN_THREAD_FEEDBACK_DISSATISFIED_CONFUSING_PROCESS, MESSAGING_IN_THREAD_FEEDBACK_DISSATISFIED_NOT_HELPFUL, MESSAGING_IN_THREAD_FEEDBACK_DISSATISFIED_SLOW_RESPONSES, MESSAGING_IN_THREAD_FEEDBACK_DISSATISFIED_SUSPICIOUS_BEHAVIOR, MESSAGING_IN_THREAD_FEEDBACK_DISSATISFIED_TOO_MANY_MESSAGES, MESSAGING_IN_THREAD_FEEDBACK_DISSATISFIED_OTHER, MESSAGING_IN_THREAD_DXMA_FEEDBACK_SATISFIED, MESSAGING_IN_THREAD_DXMA_FEEDBACK_DISSATISFIED, MESSAGING_MSGR_BUYER_SATISFIED_WITH_PURCHASE, MESSAGING_MSGR_BUYER_DISSATISFIED_WITH_PURCHASE, MESSAGING_IG_BUYER_SATISFIED_WITH_CONVERSATION, MESSAGING_IG_BUYER_DISSATISFIED_WITH_CONVERSATION, MESSAGING_CONVERSATION_SELLER_FEEDBACK_SATISFIED, MESSAGING_CONVERSATION_SELLER_FEEDBACK_DISSATISFIED, MESSAGING_CONVERSATION_SELLER_FEEDBACK_BAN, MESSAGING_CONVERSATION_SELLER_FEEDBACK_REPORT_SPAM, MESSAGING_MARK_SPAM, MESSAGING_REPLY, MESSAGING_FIRST_REPLY, MESSAGING_FIRST_REPLY_CONTINUATION, MESSAGING_OPEN_THREAD, MESSAGING_IGNORE_REQUEST, MESSAGING_PROMOTIONAL_OFF, MESSAGING_READ_RECEIPT, MESSAGING_DELIVERY_RECEIPT, MESSAGING_DELETE_MESSAGE, MESSAGING_CONVERSATION_STARTED_7D, MESSAGING_DEEP_CONVERSATION, MESSAGING_DEEP_CONVERSATION_SHADOW, MESSAGING_DEDUP_DEEP_CONVERSATION, MESSAGING_SYNTHETIC_DEEP_CONVERSATION, MESSAGING_AUTOMATED_FLOW_COMPLETE, MESSAGING_AUTOMATED_FLOW_CANCELLED, MESSENGER_RECEIPT_TEMPLATE, MESSAGING_PAGE_SEND, MESSAGING_PAGE_SEND_AFTER_USER_SEND, MESSAGING_USER_DEPTH_2_MESSAGE_SEND, MESSAGING_USER_DEPTH_2_MESSAGE_SEND_CONTINUATION, MESSAGING_USER_DEPTH_3_MESSAGE_SEND, MESSAGING_USER_DEPTH_3_MESSAGE_SEND_CONTINUATION, MESSAGING_USER_DEPTH_5_MESSAGE_SEND, MESSAGING_PAGE_DEPTH_2_MESSAGE_SEND, MESSAGING_PAGE_DEPTH_2_MESSAGE_SEND_CONTINUATION, MESSAGING_CONVERSATION_DEPTH, MESSAGING_CONVERSATION_DEPTH_NEW_WHATSAPP_SCHEMA, MESSAGING_QUALIFIED_LEAD, MESSAGING_APPOINTMENT_BOOKED, MESSAGING_PAGE_SEND_NUM_SAME_CONVERSATION, MESSAGING_USER_SEND_NUM_SAME_CONVERSATION, MESSAGING_BUSINESS_CALLING_OPT_IN_SENT, MESSAGING_BUSINESS_CALLING_OPT_IN_ACCEPTED, MESSAGING_BUSINESS_CALLING_OPT_IN_DENIED, MESSAGING_BUSINESS_CALLING_CALL_INITIATED, MESSAGING_BUSINESS_CALLING_CALL_ANSWERED, MESSAGING_BUSINESS_CALLING_CALL_MISSED, MESSAGING_BUSINESS_CALLING_CALL_DENIED, MESSAGING_BUSINESS_LLAMA_CONVERSION_POSITIVE, MESSAGING_BUSINESS_LLAMA_CONVERSION_NEGATIVE, MESSAGING_FIRST_BIZ_REPLY, MESSAGING_FIRST_BIZ_REPLY_CONTINUATION, MESSAGING_FIRST_CALL, MESSAGING_FIRST_LONG_CALL, MESSAGING_USER_PHONE_CALL_DIALOG_CONFIRM_CLICKED, MESSAGING_USER_CALL_ATTEMPTED, MESSAGING_PAGE_CALL_ATTEMPTED, MESSAGING_CONNECTED_CALL_OR_DC, MESSAGING_CALL_ATTEMPT_AND_DC, MESSAGING_CALL_ATTEMPT_AND_PAGE_INTERACTION, MESSAGING_MISSED_CALL, MESSAGING_USER_SUBSCRIBED, MESSAGING_CONVERSATION_ENGAGED, MESSAGING_WELCOME_MESSAGE_VIEW, MESSAGING_CONVERSATION_REPLIED_7D, TOTAL_MESSAGING_CONNECTION, DOWN_FUNNEL_PURCHASE, MESSAGING_DOWN_FUNNEL_PURCHASE, MESSAGING_DOWN_FUNNEL_PURCHASE_VALUE, MESSAGING_EVENT_OPTIMIZATION_LEAD, MESSAGING_SHALLOW_LEAD, MESSAGING_DOWN_FUNNEL_LOW_PRECISION_PURCHASE, REFERRAL_SENDER_INVITES_SENT, REFERRAL_SENDER_MESSAGE_SENT, REFERRAL_RECEIVER_IMPRESSION, REFERRAL_RECEIVER_CLICK, VIDEO_HOME_SELECTED, VIDEO_HOME_WATCHLIST, VIDEO_HOME_EXPLORE, VIDEO_HOME_PLAYER_START, VIDEO_HOME_90_SECOND_VIEW, FUNDRAISER_CREATE, MESSENGER_CONNECTED_CALL, MESSENGER_MISSED_CALL, D2_RETENTION, D7_RETENTION, MOVIE_SHOWTIME_CLICK, LISTING_INTERACTION, PDP_VIEW, CLICK_TO_CALL, CLICK_TO_WEBSITE, POST_SAVE, POST_SHARE, MEANINGFUL_LISTING_INTERACTION, MARKETPLACE_MLI6, MARKETPLACE_MLI9, MARKETPLACE_MARK_AS_SOLD, ONE_PD_LPV, CLICK_TO_JOIN_NEW_CHANNEL_MEMBER, OTHER}	optimization_event
`optimization_goal` enum{NONE, APP_INSTALLS, AD_RECALL_LIFT, ENGAGED_USERS, EVENT_RESPONSES, IMPRESSIONS, LEAD_GENERATION, QUALITY_LEAD, LINK_CLICKS, OFFSITE_CONVERSIONS, PAGE_LIKES, POST_ENGAGEMENT, QUALITY_CALL, REACH, LANDING_PAGE_VIEWS, VISIT_INSTAGRAM_PROFILE, ENGAGED_PAGE_VIEWS, VALUE, THRUPLAY, DERIVED_EVENTS, APP_INSTALLS_AND_OFFSITE_CONVERSIONS, CONVERSATIONS, IN_APP_VALUE, MESSAGING_PURCHASE_CONVERSION, MESSAGING_DEEP_CONVERSATION_AND_FOLLOW, SUBSCRIBERS, REMINDERS_SET, MEANINGFUL_CALL_ATTEMPT, PROFILE_VISIT, PROFILE_AND_PAGE_ENGAGEMENT, ADVERTISER_SILOED_VALUE, AUTOMATIC_OBJECTIVE, MESSAGING_APPOINTMENT_CONVERSION}	optimization_goal
`pixel_id` numeric string	pixel_id
`promoted_object_page_id` numeric string	promoted_object_page_id
`promoted_object_product_set_id` numeric string	promoted_object_product_set_id
`rank_by` string	Default value: `"ads_revenue"` rank_by
`use_case` enum {AD_STRATEGIES, AUTOMATED_APP_ADS, AUTOMATED_SHOPPING_ADS, AUTOMATED_SHOPPING_ADS_MDSA, LEAD_GEN_ASC_ADS, MANUAL_FLOW_APP_ADS, MANUAL_FLOW_SHOPS_ADS, MANUAL_FLOW_WEBSITE_ADS, MANUAL_FLOW_WEBSITE_AND_APP_ADS, SALES_WEB_APP_ADS}	Default value: `"AUTOMATED_SHOPPING_ADS"` use_case

Fields

Reading from this edge will return a JSON formatted result:

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

data

A list of Ad nodes.

paging

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

Error Codes

Error Code	Description
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token

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.