> ## 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 Instagram ü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 Instagram-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. Instagram-Anzeigen erfordern ein Instagram-Business-Konto, das über Facebook verbunden ist, eine zugehörige Facebook-Seite und die Berechtigung `ads_management`. Verknüpfen Sie das Konto erneut über Facebook, um diese Berechtigung zu erteilen. Konten, die mit Instagram Login verbunden sind, können diese Ads-Endpunkte nicht verwenden. Die Medien-ID und die Instagram-Konto-ID werden aus Ihrem verknüpften Konto ermittelt; senden Sie kein `instagram_user_id`. Der `socialPostId`-Selektor akzeptiert auch den Instagram-spezifischen Alias `igPostId`. `fbPostId` gilt nur für Facebook. Erfolgreiche Antworten enthalten `platform: "instagram"`, `socialPostId` und `igPostId`. ## Header-Parameter ## Body-Parameter Ein eindeutiger, nicht leerer Schlüssel für diese Boost-Anfrage. Wiederholen Sie dieselbe Payload mit demselben Schlüssel, um das Erstellen einer doppelten Anzeige zu vermeiden. Die Wiederverwendung des Schlüssels mit einer anderen Payload oder Plattform gibt HTTP 409 zurück. Eine noch laufende Anfrage gibt ebenfalls 409 zurück; eine nicht verfügbare Reservierung gibt 503 zurück, ohne eine Anzeige zu erstellen. Erlauben Sie Meta, das Budget zwischen Anzeigengruppen der Kampagne aufzuteilen. Die ID des Instagram-Werbekontos, auf dem der Beitrag beworben werden soll. Die Konto-ID kann über den [Werbekonten-Endpunkt](/docs/apis/ads/instagram/get-ad-accounts) abgerufen werden. Name für Ihre Anzeige (wird im Instagram Ad Manager angezeigt) im Format `{adName} - {postId oder socialPostId} - {aktuelles Datum}`. Maximaler Gebotsbetrag in USD, als positiver Betrag mit bis zu zwei Dezimalstellen. Tagesbudget in USD. Verwenden Sie einen positiven Betrag mit bis zu zwei Dezimalstellen. Meta kann zusätzliche Mindestbeträge für Ihr Konto und Ziel durchsetzen. Die [Instagram-Social-Post-ID](/docs/apis/overview#social-post-id) des zu bewerbenden Beitrags, die es Ihnen ermöglicht, eine Anzeige aus einem direkt auf Instagram erstellten Beitrag zu erstellen. Dies ist die ID des [Beitrags auf Instagram](/docs/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](/docs/apis/ads/instagram/boost-post#anzeigenziele). Zielländer mit `{"countries": ["US", "CA"]}` unter Verwendung von [Ländercodes](/docs/iso-codes/country). Sie können auch `regions`- und `cities`-Arrays angeben; siehe [Regionen](/docs/apis/ads/instagram/get-ad-regions) und [Städte](/docs/apis/ads/instagram/get-ad-cities). Die [Ayrshare-Post-ID](/docs/apis/overview#ayrshare-post-id) des zu bewerbenden Beitrags. Erforderlich, wenn `socialPostId` 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](/docs/apis/ads/instagram/put-ad-update) ändern. Verfolgen Sie die Anzeige mit einem Meta-Pixel. Die ID des Meta-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 korrekt angeben. Meta setzt menschliche Prüfer und maschinelles Lernen ein, um solche Anzeigen zu identifizieren. Wenn Sie uns eine falsche `specialAdCategories` senden, besteht das Risiko, dass Ihre Anzeigen pausiert werden, bis die Kampagne angepasst ist. Die Person oder Organisation, die von der Anzeige profitiert. Muss zusammen mit `dsaPayor` gesetzt werden. Verwenden Sie den [DSA-Empfehlungen-Endpunkt](/docs/apis/ads/instagram/get-dsa-recommendations) für Vorschläge. Die Person oder Organisation, die für die Anzeige bezahlt. Muss zusammen mit `dsaBeneficiary` gesetzt werden. 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 derselben `countries`-, `regions`- und `cities`-Struktur wie bei `locations` aus. Das Geschlecht der Zielgruppe. Werte: `all`, `male`, `female`. Die Ziel-Interessen der Anzeige als Array von Instagram-[Interessen-IDs](/docs/apis/ads/instagram/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. Ersetzen Sie die Beispiel-IDs durch Ihre eigenen. Setzen Sie `startDate` und `endDate` auf Ihren geplanten Zeitplan; die Beispieldaten dienen nur zur Veranschaulichung. ```bash cURL theme={"system"} curl -X POST https://api.ayrshare.com/api/ads/instagram/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/instagram/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/instagram/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/instagram/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/instagram/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/instagram/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/instagram/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); payload.put("locations", Map.of("countries", Arrays.asList("US"))); 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/instagram/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", "socialPostId": "1234567890", "igPostId": "1234567890", "platform": "instagram", "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: accountId" } ```