DSA Recommendations

GEThttps://api.acme.com/api/ads/facebook/dsaRecommendations

Available on Premium, Business, Enterprise plans.

Get Digital Services Act (DSA) recommendations for your Facebook ad account.

As part of the requirements set forth by the European Union (EU) Digital Services Act (DSA), Facebook requires ads targeting any part of the EU to provide string values defining the beneficiary and payor of the ad being created

This endpoint provides a list of recommended DSA beneficiaries and payors that can be used when boosting posts. These fields may be used in dsaBeneficiary and dsaPayor.

Outputs a list of strings (maximum 25) that Facebook has identified to likely be the beneficiary/payor, based on recent activity of the ad account.
These recommendations can be used as values for the dsaBeneficiary and dsaPayor parameters in the Boost Post endpoint.
Both dsaBeneficiary and dsaPayor must be set together if either is provided when boosting posts.

Header Parameters

Authorizationstringrequired

API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

Profile-Keystring

Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Query Parameters

accountIdstringrequired

The ID of the Facebook ad account to get DSA recommendations for. The account ID can be retrieved from the ad accounts endpoint.

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.acme.com/api/ads/facebook/dsaRecommendations?accountId=1234567890

{
    "status": "success",
    "dsaRecommendations": [
        "Beneficiary 1",
        "Beneficiary 2",
        "Beneficiary 3"
    ],
    "count": 1
}