v0.2.0-beta

OpenAPI 3.1.0

Live-Aufgaben für „Bing Ads Audience Estimation“ einstellen

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operationen

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

Live-Aufgaben für „Bing Ads Audience Estimation“ einstellen

Schätzt die mit einem bestimmten bid und daily_budget erreichbare Bing-Ads-Zielgruppe, eingegrenzt durch location_code, age, Branche und Berufsfunktion. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. Branchen- und Berufsfunktionswerte stammen aus get_dataforseo_keywords_bing_audience_industries und get_dataforseo_keywords_bing_audience_job_functions – beide kostenlos und beide lesenswert, bevor Sie eine Anfrage zusammenstellen. Die Submit- und Fetch-Pendants dieses Endpunkts erledigen dieselbe Arbeit asynchron, zum selben Preis, für Batches, die zu groß zum Warten sind.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.09.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- age
  Typ: array string[] | null
  
  Auswahl von Altersgruppen für das Targeting
  mögliche Werte: eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve
- bid
  Typ: number | null
  
  gewünschter Gebotswert in USD
  Höchstwert: 1000
- daily_budget
  Typ: number | null
  
  tägliches Kampagnenbudget in USD
  Höchstwert: 10000
- gender
  Typ: array string[] | null
  
  Zielgeschlecht
  mögliche Werte: male, female, unknown
- industry
  Typ: array string[] | null
  
  Branche für das LinkedIn-Profil-Targeting
  
  wenn Sie dieses Feld verwenden, können Sie die Liste der verfügbaren Branchennamen mit industry_id abrufen, indem Sie eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries senden
  
  Beispiel: 806301758
- job_function
  Typ: array string[] | null
  
  Funktion für das LinkedIn-Profil-Targeting
  
  wenn Sie dieses Feld verwenden, können Sie die Liste der verfügbaren Funktionsnamen mit job_function_id abrufen, indem Sie eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions senden
  
  Beispiel: 806300451
- location_code
  Typ: integer
  
  Standortcode der Suchmaschine
  Pflichtfeld, wenn nicht angegeben location_name oder location_coordinate
  bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_coordinate nötig
  Die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/locations
  Beispiel:
  2840
- location_coordinate
  Typ: string
  
  GPS-Koordinaten eines Standorts
  Pflichtfeld, wenn nicht angegeben location_name oder location_code
  bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_code nötig
  Der Parameter location_coordinate muss im Format "latitude,longitude,radius (in km)" angegeben werden
  die Daten werden für das Land geliefert, zu dem die angegebenen Koordinaten gehören
  Beispiel:
  29.6821525,-82.4098881,100
- location_name
  Typ: string
  
  vollständiger Name des Suchmaschinenstandorts
  Pflichtfeld, wenn nicht angegeben location_code oder location_coordinate
  bei Verwendung dieses Feldes ist keine Angabe von location_code oder location_coordinate nötig
  Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/locations
  Beispiel:
  London,England,United Kingdom

Antworten

200
Typ: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

tasks
Typ: array (object | null)[] | null

Array von Aufgaben

Typ: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

propertyName
Typ: object | null
id
Typ: string | null

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

path
Typ: array (string | null)[] | null

URL-Pfad

result
Typ: array (object | null)[] | null

Array von Ergebnissen

currency
Typ: string | null

Währungsname

Beispiel: USDollar

est_audience_size
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

monatlich geschätztes Reichweitenintervall der Nutzerzahl

high
Typ: number | null Format: double

gibt die Obergrenze des Bereichsergebnisses an

low
Typ: number | null Format: double

gibt die Untergrenze des Bereichsergebnisses an

est_clicks
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

monatlich geschätztes Intervall der Klickzahl

high
Typ: number | null Format: double

gibt die Obergrenze des Bereichsergebnisses an

low
Typ: number | null Format: double

gibt die Untergrenze des Bereichsergebnisses an

est_cost_per_event
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

gibt die geschätzten Kosten pro Ereignis als Intervall an

high
Typ: number | null Format: double

gibt die Obergrenze des Bereichsergebnisses an

low
Typ: number | null Format: double

gibt die Untergrenze des Bereichsergebnisses an

est_ctr
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

geschätztes Intervall der Klickrate

high
Typ: number | null Format: double

gibt die Obergrenze des Bereichsergebnisses an

low
Typ: number | null Format: double

gibt die Untergrenze des Bereichsergebnisses an

est_impressions
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

monatlich geschätztes Intervall der Impressionen

high
Typ: number | null Format: double

gibt die Obergrenze des Bereichsergebnisses an

low
Typ: number | null Format: double

gibt die Untergrenze des Bereichsergebnisses an

est_reach_audience_size
Typ: integer | null Format: int64

monatlich geschätzte Nutzerzahl

est_reach_impressions
Typ: integer | null Format: int64

monatlich geschätzte Impressionen

est_spend
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

monatlich geschätztes Ausgabenintervall

high
Typ: number | null Format: double

gibt die Obergrenze des Bereichsergebnisses an

low
Typ: number | null Format: double

gibt die Untergrenze des Bereichsergebnisses an

events_lost_to_bid
Typ: integer | null Format: int64

gibt die Anzahl der verlorenen Ereignisse aufgrund eines zu niedrigen Eingabegebots an

events_lost_to_budget
Typ: integer | null

gibt die Anzahl der verlorenen Ereignisse aufgrund eines zu niedrigen Eingabebudgets an

suggested_bid
Typ: number | null

vorgeschlagenes Gebot unter dem aktuellen Targeting

suggested_budget
Typ: number | null Format: double

vorgeschlagenes Tagesbudget unter dem aktuellen Targeting und Gebot

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

application/json

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_coordinate": "29.6821525,-82.4098881,100",
    "age": [
      "twenty_five_to_thirty_four",
      "eighteen_to_twenty_four",
      "unknown"
    ],
    "bid": 1,
    "daily_budget": 24,
    "gender": [
      "male"
    ],
    "industry": [
      "806303407",
      "806301758"
    ],
    "job_function": [
      "806298607"
    ]
  }
]'

Schema anzeigen

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "est_impressions": {
            "high": null,
            "low": null
          },
          "est_audience_size": {
            "high": null,
            "low": null
          },
          "est_clicks": {
            "high": null,
            "low": null
          },
          "est_spend": {
            "high": null,
            "low": null
          },
          "est_cost_per_event": {
            "high": null,
            "low": null
          },
          "est_ctr": {
            "high": null,
            "low": null
          },
          "suggested_bid": null,
          "suggested_budget": null,
          "events_lost_to_bid": null,
          "events_lost_to_budget": null,
          "est_reach_audience_size": null,
          "est_reach_impressions": null,
          "currency": null
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live-Aufgaben für „Bing Ads Audience Estimation“ einstellen

AuthentifizierungRequired

DataForSEO

Live-Aufgaben für „Bing Ads Audience Estimation“ einstellen

Preisreferenz