The instagram_actor_id
field for the act_<AD_ACCOUNT_ID>/adcreatives
has been deprecated for v22.0 and will be deprecated for all versions January 20, 2026. Please migrate your API calls to use the instagram_user_id
field.
Learn more in the
v22.0 API Changelog
and
our News for Developers blog post.
To get suggested tags based on an image hash, you can make a GET
request to /{ad-account-id}/suggested_product_tags
.
curl -X GET -G \ -F 'image_hash=<IMAGE_HASH>' \ -F 'is_shops_ad=true' \ -F 'instagram_user_id=<IG_USER_ID>' \ -F 'page_id=<PAGE_ID>' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/suggested_product_tags
{ "data": [ { "product_id":<PRODUCT_ID_1>, "x": 0.5, "y": 0.6 }, { "product_id": <PRODUCT_ID_2>, "x": 0.2, "y": 0.7 } ] }
Name | Description |
---|---|
string | Product ID of the product tag. |
float | X-coordinate of the product tag. |
float | Y-coordinate of the product tag. |
Parameter | Description |
---|---|
image_hash string | Returned after uploading an image to Required |
instagram_actor_id numeric string or integer | Either a Page-connected Instagram account ID or the Page-backed Instagram account ID. See more details in Set Up Instagram Accounts With Pages. Required |
is_shops_ad boolean | Whether you want to use the suggested product tags and the image for Shops ads. Required |
page_id numeric string | The ID for your Page. Required |
Reading from this edge will return a JSON formatted result:
{ "
data
": [], "paging
": {} }
data
paging
Error | Description |
---|---|
100 | Invalid parameter |