v0.2.0-beta

OpenAPI 3.1.0

Vytváření úloh live ‘Bing Ads Audience Estimation’

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

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

DataForSEO Operace

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

Vytváření úloh live ‘Bing Ads Audience Estimation’

Odhaduje publikum Bing Ads dosažitelné při daném bid a daily_budget, zúžené pomocí location_code, age, odvětví a pracovní funkce. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200. Hodnoty odvětví a pracovních funkcí pocházejí z get_dataforseo_keywords_bing_audience_industries a get_dataforseo_keywords_bing_audience_job_functions – oba jsou zdarma a oba se vyplatí přečíst před sestavením požadavku. Protějšky pro odeslání a načtení tohoto endpointu dělají stejnou práci asynchronně, za stejnou cenu, pro dávky příliš velké na čekání.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.09.
Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

application/json

Typ: array (object | null)[]
- age
  Typ: array string[] | null
  
  výběr věkových rozsahů pro cílení
  možné hodnoty: 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
  
  požadovaná hodnota nabídky v USD
  maximální hodnota: 1000
- daily_budget
  Typ: number | null
  
  hodnota denního rozpočtu kampaně v USD
  maximální hodnota: 10000
- gender
  Typ: array string[] | null
  
  pohlaví pro cílení
  možné hodnoty: male, female, unknown
- industry
  Typ: array string[] | null
  
  odvětví cílení profilu LinkedIn
  
  pokud toto pole použijete, seznam dostupných názvů odvětví s industry_id získáte odesláním samostatného požadavku na adresu https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  příklad: 806301758
- job_function
  Typ: array string[] | null
  
  pracovní pozice cílení profilu LinkedIn
  
  pokud toto pole použijete, seznam dostupných názvů pracovních pozic s job_function_id získáte odesláním samostatného požadavku na adresu https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  příklad: 806300451
- location_code
  Typ: integer
  
  kód lokality vyhledávače
  povinné pole, pokud nezadáte location_name nebo location_coordinate
  pokud toto pole použijete, nemusíte zadávat location_name ani location_coordinate
  seznam dostupných lokalit vyhledávačů s jejich location_code získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/locations
  příklad:
  2840
- location_coordinate
  Typ: string
  
  GPS souřadnice lokality
  povinné pole, pokud nezadáte location_name nebo location_code
  pokud toto pole použijete, nemusíte zadávat location_name ani location_code
  parametr location_coordinate je nutné zadat ve formátu "latitude,longitude,radius (in km)"
  data budou vrácena pro zemi, do které zadané souřadnice patří
  příklad:
  29.6821525,-82.4098881,100
- location_name
  Typ: string
  
  úplný název lokality vyhledávače
  povinné pole, pokud nezadáte location_code nebo location_coordinate
  pokud toto pole použijete, nemusíte zadávat location_code ani location_coordinate
  seznam dostupných lokalit vyhledávače s jejich location_name získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/locations
  příklad:
  London,England,United Kingdom

Odpovědi

200
Typ: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

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

pole úloh

Typ: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

obsahuje stejné parametry, které jste zadali v požadavku POST

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

identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

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

cesta URL

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

pole výsledků

currency
Typ: string | null

název měny

příklad: USDollar

est_audience_size
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

rozsah odhadovaného měsíčního dosahu uživatelů

high
Typ: number | null Formát: double

označuje horní mez výsledku rozsahu

low
Typ: number | null Formát: double

označuje dolní mez výsledku rozsahu

est_clicks
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

rozsah odhadovaného měsíčního počtu kliknutí

high
Typ: number | null Formát: double

označuje horní mez výsledku rozsahu

low
Typ: number | null Formát: double

označuje dolní mez výsledku rozsahu

est_cost_per_event
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

udává odhadované náklady na událost s výsledkem rozsahu

high
Typ: number | null Formát: double

označuje horní mez výsledku rozsahu

low
Typ: number | null Formát: double

označuje dolní mez výsledku rozsahu

est_ctr
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

rozsah odhadované míry prokliku

high
Typ: number | null Formát: double

označuje horní mez výsledku rozsahu

low
Typ: number | null Formát: double

označuje dolní mez výsledku rozsahu

est_impressions
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

rozsah odhadovaného měsíčního počtu zobrazení

high
Typ: number | null Formát: double

označuje horní mez výsledku rozsahu

low
Typ: number | null Formát: double

označuje dolní mez výsledku rozsahu

est_reach_audience_size
Typ: integer | null Formát: int64

odhadovaný měsíční počet uživatelů

est_reach_impressions
Typ: integer | null Formát: int64

odhadovaný měsíční počet zobrazení

est_spend
Typ: object | null · Response36Afe1097B20_AudienceEstimationInfo

rozsah odhadovaných měsíčních výdajů

high
Typ: number | null Formát: double

označuje horní mez výsledku rozsahu

low
Typ: number | null Formát: double

označuje dolní mez výsledku rozsahu

events_lost_to_bid
Typ: integer | null Formát: int64

udává počet ztracených událostí kvůli nedostatečné vstupní nabídce

events_lost_to_budget
Typ: integer | null

udává počet ztracených událostí kvůli nedostatečnému vstupnímu rozpočtu

suggested_bid
Typ: number | null

navrhovaná hodnota nabídky při aktuálním cílení

suggested_budget
Typ: number | null Formát: double

navrhovaná hodnota denního rozpočtu při aktuálním cílení a nabídce

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

počet úloh v poli tasks vrácených s chybou

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

aktuální verze API
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

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"
    ]
  }
]'

Zobrazit schéma

{
  "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
        }
      ]
    }
  ]
}

Úspěšná operace

Vytváření úloh live ‘Bing Ads Audience Estimation’

OvěřováníRequired

DataForSEO

Vytváření úloh live ‘Bing Ads Audience Estimation’

Cenová reference