Skip to main content
GET
/
ads
/
facebook
/
dsaRecommendations
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/dsaRecommendations?accountId=1234567890

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

Documentation Index

Fetch the complete documentation index at: https://ayrshare.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Available on plan.
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

​
Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
​
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

​
Query Parameters

​
accountId
string
required
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.ayrshare.com/api/ads/facebook/dsaRecommendations?accountId=1234567890

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