> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Beitrag bewerben > Bewerben Sie einen Beitrag, indem Sie ihn an die Werbeplattform von Facebook übermitteln export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <> API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY {!noProfileKey && (profileKeyRequired ? Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY : Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY )} ; Bewerben Sie einen bestehenden Facebook-Beitrag, um eine Anzeige zu erstellen. Dieser Endpunkt ermöglicht es Ihnen, Ihre organischen Beiträge mit benutzerdefinierten Targeting-, Budget- und Zeitplanparametern in bezahlte Anzeigen umzuwandeln. ### Anzeigenziele Jede Anzeige muss ein Ziel haben. Das Ziel bestimmt, wie die Anzeige für die Anzeige optimiert wird. Erfahren Sie mehr über die Integration der Facebook Marketing API mit Ayrshare in unserem [Facebook Marketing API-Integrationsleitfaden](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/). ## Header-Parameter ## Body-Parameter Die ID des Facebook-Werbekontos, auf dem der Beitrag beworben werden soll. Die Konto-ID kann über den [Werbekonten-Endpunkt](/apis/ads/facebook/get-ad-accounts) abgerufen werden. Name für Ihre Anzeige (wird im Facebook Ad Manager angezeigt) im Format `{adName} - {postId oder fbPostId} - {aktuelles Datum}`. Maximaler Gebotsbetrag in USD. Der Mindestgebotsbetrag beträgt 1,00 \$. Tagesbudget in USD. Das Mindestbudget beträgt 1,00 \$. Die [Facebook-Social-Post-ID](/apis/overview#social-post-id) des zu bewerbenden Beitrags, die es Ihnen ermöglicht, eine Anzeige aus einem direkt auf Facebook erstellten Beitrag zu erstellen. Dies ist die ID des [Beitrags auf Facebook](/apis/history/history-platform), nicht von Ayrshare. Erforderlich, wenn `postId` nicht gesetzt ist. Das Ziel der Anzeige. Werte: `engagement`, `interactions`, `awareness_views` und `awareness_audience`. Weitere Informationen finden Sie oben in den [Anzeigenziel-Details](/apis/ads/facebook/boost-post#anzeigenziele). Zielorte der Anzeige mit einem Objekt aus Arrays: `countries`, `regions`, `cities`. Liste der Ländercodes. ```json theme={"system"} { "countries": ["US", "CA"] } ``` Regionen erfordern den `key`-Wert der Facebook-Region. Weitere Informationen finden Sie im [Regionen-Endpunkt](/apis/ads/facebook/get-ad-regions). ```json theme={"system"} { "regions": [{ "key": "3886" }] } ``` Städte erfordern: `key` (von Facebook), `radius` und `distance_unit`. `radius` ist die Entfernung um die Stadt: 10–50 Meilen oder 17–80 Kilometer. `distance_unit` ist `mile` oder `kilometer`. Weitere Informationen finden Sie im [Städte-Endpunkt](/apis/ads/facebook/get-ad-cities). ```json theme={"system"} { "cities": [ { "key": "2420605", "radius": 25, "distance_unit": "mile" } ] } ``` Die [Ayrshare-Post-ID](/apis/overview#ayrshare-post-id) des zu bewerbenden Beitrags. Erforderlich, wenn `fbPostId` nicht gesetzt ist. Der Status der Anzeige. Werte: `active` und `paused`. Sie können den Status der Anzeige später über den [Anzeige aktualisieren-Endpunkt](/apis/ads/facebook/put-ad-update) ändern. Steuert die Budget-Freigabe von Meta auf Kampagnenebene für Anzeigengruppen. Meta verlangt dieses Wire-Feld jetzt in jeder Kampagne, die ohne Budget auf Kampagnenebene erstellt wird, weshalb Ayrshare es immer sendet – standardmäßig auf `false` gesetzt, um die Abwärtskompatibilität zu wahren. Setzen Sie es auf `true`, damit Meta bis zu \~20 % des Budgets einer Anzeigengruppe an andere Anzeigengruppen derselben Kampagne verteilen kann, um die Gesamtperformance zu optimieren. Details finden Sie in der [Referenz zu Anzeigenkampagnen-Gruppen](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/) von Meta. Verfolgen Sie die Anzeige mit einem Facebook-Pixel. Die ID des Facebook-Pixels zur Verfolgung der Anzeige. ```json theme={"system"} { "pixelId": 1234567890 } ``` Fügen Sie UTM-Tags zur Anzeigen-URL hinzu. ```json theme={"system"} { "urlTags": ["utm_source=ayrshare", "utm_medium=social", "utm_campaign=ayrshare-social"] } ``` Zum Beispiel, wenn die Link-URL `https://www.mysite.com/my-post` lautet und die hinzugefügten URL-Tags: `utm_source=ayrshare`, `utm_medium=social` und `utm_campaign=ayrshare-social` sind. Die Anzeigen-URL lautet dann: `https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social`. Meta verlangt von Werbetreibenden in [speziellen Anzeigenkategorien](https://www.facebook.com/business/help/298000447747885?helpref=faq_content), dass sie ihre Kampagnenkategorie selbst deklarieren. Wenn Ihr Unternehmen in eine dieser Kategorien fällt, müssen Sie beim Bewerben Ihres Beitrags die entsprechende Kategorie auswählen. Die folgenden Werte werden unterstützt:
  • `housing`: Anzeigen, die für eine Wohnmöglichkeit oder einen damit verbundenen Service werben oder direkt darauf verlinken, einschließlich, aber nicht beschränkt auf Inserate zum Verkauf oder zur Vermietung einer Wohnung oder eines Hauses, Wohngebäudeversicherungen, Hypothekenversicherungen, Hypothekendarlehen, Wohnungsreparaturen sowie Home-Equity- oder Wertermittlungsdienste.
  • `financial_product_services`: Anzeigen, die für Finanzprodukte und -dienstleistungen werben oder direkt darauf verlinken, einschließlich Krediten.
  • `employment`: Anzeigen, die für eine Beschäftigungsmöglichkeit werben oder direkt darauf verlinken, einschließlich, aber nicht beschränkt auf Teil- oder Vollzeitjobs, Praktika oder berufliche Zertifizierungsprogramme. Verwandte Anzeigen, die in diese Kategorie fallen, umfassen Werbung für Jobbörsen oder Jobmessen, Aggregations- dienste oder Anzeigen, die Vorteile eines Unternehmens beschreiben, unabhängig von einem konkreten Stellenangebot.
  • `issues_elections_politics`: Anzeigen, die von, im Namen von oder über einen Kandidaten für ein öffentliches Amt, eine politische Persönlichkeit, eine politische Partei geschaltet werden oder für ein bestimmtes Wahlergebnis werben. Dazu gehören auch Anzeigen über Wahlen, Referenden oder Volksabstimmungen, einschließlich Kampagnen wie „Geh wählen“. Anzeigen, die als politische Werbung oder als Werbung zu gesellschaftlichen Themen an dem Ort reguliert sind, an dem die Anzeige geschaltet wird. Wenn Sie Themen, Wahlen oder Politik auswählen, müssen Sie das Land angeben, in dem Sie diese Anzeigen schalten möchten. Sie müssen berechtigt sein, Anzeigen zu gesellschaftlichen Themen, Wahlen oder Politik im angegebenen Land zu schalten.
Meta verlangt, dass Werbetreibende ihre Kampagnenkategorie selbst deklarieren. Meta setzt menschliche Prüfer und maschinelles Lernen ein, um solche Anzeigen zu identifizieren. Wenn Sie uns eine falsche `specialAdCategory` senden, besteht das Risiko, dass Ihre Anzeigen pausiert werden, bis die Kampagne angepasst ist. Enddatum und -uhrzeit im ISO-8601-Format (muss mindestens 30 Stunden nach dem Start liegen), zum Beispiel `2025-03-01T00:00:00Z`. Wenn nicht gesetzt, läuft die Anzeige unbegrenzt und hat ein Enddatum von `ongoing`. Schließen Sie Standorte mit einem Objekt aus, das Arrays von `countries`, `regions` und `cities` enthält. Liste der auszuschließenden Ländercodes. ```json theme={"system"} { "countries": ["US", "CA"] } ``` Regionen erfordern den `key`-Wert der Facebook-Region. Weitere Informationen finden Sie im [Regionen-Endpunkt](/apis/ads/facebook/get-ad-regions). ```json theme={"system"} { "regions": [{ "key": "3886" }] } ``` Städte erfordern: `key` (von Facebook), `radius` und `distance_unit`. `radius` ist die Entfernung um die Stadt: 10–50 Meilen oder 17–80 Kilometer. `distance_unit` ist `mile` oder `kilometer`. Weitere Informationen finden Sie im [Städte-Endpunkt](/apis/ads/facebook/get-ad-cities). ```json theme={"system"} { "cities": [ { "key": "2420605", "radius": 25, "distance_unit": "mile" } ] } ``` Das Geschlecht der Zielgruppe. Werte: `all`, `male`, `female`. Die Ziel-Interessen der Anzeige als Array von Facebook-[Interessen-IDs](/apis/ads/facebook/get-ad-interests). Maximales Alter für das Targeting der Anzeige (Standard: 65). Mindestalter für das Targeting der Anzeige (Standard: 18). Startdatum und -uhrzeit im ISO-8601-Format, zum Beispiel `2025-03-01T00:00:00Z`. Wenn nicht gesetzt, startet die Anzeige sofort. Der Begünstigte der Anzeige für die Einhaltung des Digital Services Act (DSA) in EU-Ländern. Muss zusammen mit `dsaPayor` gesetzt werden, wenn einer der beiden angegeben wird. Weitere Informationen finden Sie in unserem [DSA-Leitfaden](/apis/ads/facebook/get-dsa-recommendations). Der Zahler der Anzeige für die Einhaltung des Digital Services Act (DSA) in EU-Ländern. Muss zusammen mit `dsaBeneficiary` gesetzt werden, wenn einer der beiden angegeben wird. ```bash cURL theme={"system"} curl -X POST https://api.ayrshare.com/api/ads/facebook/boost \ -H "Authorization: Bearer API_KEY" \ -H "Content-Type: application/json" \ -d '{ "postId": "1234567890", "accountId": "1234567890", "adName": "My Ad", "status": "active", "goal": "engagement", "minAge": 18, "maxAge": 65, "locations": { "countries": ["US"] }, "budget": 100, "bidAmount": 1, "startDate": "2025-03-01T00:00:00Z", "endDate": "2025-03-07T23:59:59Z", "interests": [1234567890, 1234567891] }' ``` ```javascript JavaScript theme={"system"} const API_KEY = "API_KEY"; fetch("https://api.ayrshare.com/api/ads/facebook/boost", { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${API_KEY}` }, body: JSON.stringify({ postId: "1234567890", accountId: "1234567890", adName: "My Ad", status: "active", goal: "engagement", minAge: 18, maxAge: 65, locations: { countries: ["US"] }, budget: 100, bidAmount: 1, startDate: "2025-03-01T00:00:00Z", endDate: "2025-03-07T23:59:59Z", interests: [1234567890, 1234567891] }) }) .then((res) => res.json()) .then((json) => console.log(json)) .catch(console.error); ``` ```python Python theme={"system"} import requests API_KEY = "API_KEY" url = "https://api.ayrshare.com/api/ads/facebook/boost" payload = { "postId": "1234567890", "accountId": "1234567890", "adName": "My Ad", "status": "active", "goal": "engagement", "minAge": 18, "maxAge": 65, "locations": {"countries": ["US"]}, "budget": 100, "bidAmount": 1, "startDate": "2025-03-01T00:00:00Z", "endDate": "2025-03-07T23:59:59Z", "interests": [1234567890, 1234567891] } response = requests.post(url, headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}, json=payload) print(response.json()) ``` ```php PHP theme={"system"} "1234567890", "accountId" => "1234567890", "adName" => "My Ad", "status" => "active", "goal" => "engagement", "minAge" => 18, "maxAge" => 65, "locations" => ["countries" => ["US"]], "budget" => 100, "bidAmount" => 1, "startDate" => "2025-03-01T00:00:00Z", "endDate" => "2025-03-07T23:59:59Z", "interests" => [1234567890, 1234567891] ]; $ch = curl_init("https://api.ayrshare.com/api/ads/facebook/boost"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload)); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Content-Type: application/json", "Authorization: Bearer " . $API_KEY ]); $response = curl_exec($ch); $result = json_decode($response, true); print_r($result); curl_close($ch); ``` ```csharp C# theme={"system"} using System; using System.Net.Http; using System.Net.Http.Headers; using System.Text; using System.Text.Json; using System.Threading.Tasks; class Program { static async Task Main() { string API_KEY = "API_KEY"; var payload = new { postId = "1234567890", accountId = "1234567890", adName = "My Ad", status = "active", goal = "engagement", minAge = 18, maxAge = 65, locations = new { countries = new[] { "US" } }, budget = 100, bidAmount = 1, startDate = "2025-03-01T00:00:00Z", endDate = "2025-03-07T23:59:59Z", interests = new[] { 1234567890, 1234567891 } }; using var client = new HttpClient(); client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", API_KEY); var content = new StringContent( JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json" ); var response = await client.PostAsync("https://api.ayrshare.com/api/ads/facebook/boost", content); var responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } } ``` ```go Go theme={"system"} package main import ( "bytes" "encoding/json" "fmt" "io/ioutil" "net/http" ) func main() { apiKey := "API_KEY" payload := map[string]interface{}{ "postId": "1234567890", "accountId": "1234567890", "adName": "My Ad", "status": "active", "goal": "engagement", "minAge": 18, "maxAge": 65, "locations": map[string]interface{}{"countries": []string{"US"}}, "budget": 100, "bidAmount": 1, "startDate": "2025-03-01T00:00:00Z", "endDate": "2025-03-07T23:59:59Z", "interests": []int{1234567890, 1234567891}, } jsonData, err := json.Marshal(payload) if err != nil { fmt.Println("Error marshaling JSON:", err) return } req, err := http.NewRequest("POST", "https://api.ayrshare.com/api/ads/facebook/boost", bytes.NewBuffer(jsonData)) if err != nil { fmt.Println("Error creating request:", err) return } req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer "+apiKey) client := &http.Client{} resp, err := client.Do(req) if err != nil { fmt.Println("Error sending request:", err) return } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { fmt.Println("Error reading response:", err) return } fmt.Println(string(body)) } ``` ```java Java theme={"system"} import java.io.IOException; import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.util.Arrays; import java.util.HashMap; import java.util.Map; import com.fasterxml.jackson.databind.ObjectMapper; public class BoostPost { public static void main(String[] args) { String API_KEY = "API_KEY"; String url = "https://api.ayrshare.com/api/ads/facebook/boost"; Map payload = new HashMap<>(); payload.put("postId", "1234567890"); payload.put("accountId", "1234567890"); payload.put("adName", "My Ad"); payload.put("status", "active"); payload.put("goal", "engagement"); payload.put("minAge", 18); payload.put("maxAge", 65); Map locations = new HashMap<>(); locations.put("countries", Arrays.asList("US")); payload.put("locations", locations); payload.put("budget", 100); payload.put("bidAmount", 1); payload.put("startDate", "2025-03-01T00:00:00Z"); payload.put("endDate", "2025-03-07T23:59:59Z"); payload.put("interests", Arrays.asList(1234567890, 1234567891)); try { ObjectMapper objectMapper = new ObjectMapper(); String requestBody = objectMapper.writeValueAsString(payload); HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .header("Content-Type", "application/json") .header("Authorization", "Bearer " + API_KEY) .POST(HttpRequest.BodyPublishers.ofString(requestBody)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } catch (IOException | InterruptedException e) { e.printStackTrace(); } } } ``` ```ruby Ruby theme={"system"} require 'net/http' require 'uri' require 'json' API_KEY = "API_KEY" uri = URI.parse("https://api.ayrshare.com/api/ads/facebook/boost") payload = { postId: "1234567890", accountId: "1234567890", adName: "My Ad", status: "active", goal: "engagement", minAge: 18, maxAge: 65, locations: { countries: ["US"] }, budget: 100, bidAmount: 1, startDate: "2025-03-01T00:00:00Z", endDate: "2025-03-07T23:59:59Z", interests: [1234567890, 1234567891] } http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = true request = Net::HTTP::Post.new(uri.request_uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer #{API_KEY}" request.body = payload.to_json response = http.request(request) puts response.body ``` ```json 200: Beitrag beworben theme={"system"} { "status": "success", "adId": "120217670757750410", "adName": "API Post - DE6gpw8kxlonHy2b7Lo - 2025-03-26T23:42:43", "adStatus": "active", "bidAmount": 10, "budget": 100, "endDate": "2026-03-28T22:30:00Z", "goal": { "title": "Get More Engagement", "description": "This goal seeks to increase engagement...", "type": "engagement" }, "interests": [ "6003195554098" ], "locations": { "countries": ["US"] }, "maxAge": 65, "minAge": 18, "postId": "DE6gpw8kxlonHy2b7Lo", "startDate": "2026-03-26T22:30:00Z" } ``` ```json 400: Ungültige Konto-ID theme={"system"} { "action": "boost post", "status": "error", "code": 369, "message": "Unable to boost post. Please try again or contact us if the issue persists.", "details": "The accountId likely does not exist. Please check the accountId and try again." } ``` ```json 400: Fehlende Pflichtparameter theme={"system"} { "action": "request", "status": "error", "code": 101, "message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis", "details": "Missing required fields: budget" } ```