Felo API PlatformFelo API Platform
Alle endpoints van DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Taken voor ‘Keywords For Site’ instellen

Server:https://openapi.felo.ai
Clientbibliotheken

DataForSEO

​

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

Taken voor ‘Keywords For Site’ instellen

​

Zet een Google Ads-taak voor website-keywords in de wachtrij en retourneert een taak-id. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. 🔴 Het resultaat heeft dezelfde orde van 7.2 MB als de live-tweeling. Haal op met get_dataforseo_keywords_gads_kw_for_site_fetch.

Prijsreferentie

  • Afrekening: gerapporteerde responskosten.
  • Referentieschatting per verzoek: USD 0.09.
  • Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body
application/json
  • Type: array (object | null)[]
    • date_from
      Type: string | null

      startdatum van het tijdsbereik
      optioneel veld
      datumnotatie: "yyyy-mm-dd"
      minimumwaarde: 4 jaar vanaf de huidige datum
      standaard worden gegevens voor de afgelopen 12 maanden geretourneerd;
      Let op: de opgegeven datum mag niet groter zijn dan de datum in date_to en/of de datum van gisteren;als Status-endpoint false retourneert in het veld actual_data, kan date_from worden ingesteld op de maand vóór de vorige en eerder;
      als Status-endpoint true retourneert in het veld actual_data, kan date_from worden ingesteld op de vorige maand en eerder

    • date_to
      Type: string | null

      einddatum van het tijdsbereik
      optioneel veld
      Let op: de opgegeven datum mag niet groter zijn dan de datum van gisteren;
      als u dit veld niet opgeeft, wordt standaard de datum van gisteren gebruikt
      datumnotatie: "yyyy-mm-dd"
      voorbeeld:
      "2022-11-30"

    • include_adult_keywords
      Type: boolean | null

      keywords met betrekking tot inhoud voor volwassenen opnemen
      optioneel veld
      bij true worden keywords voor volwassenen in de respons opgenomen
      standaardwaarde: false
      let op dat de API voor zulke keywords mogelijk geen gegevens retourneert vanwege beperkingen van Google Ads

    • language_code
      Type: string | null

      taalcode van de zoekmachine
      optioneel veld
      de lijst met beschikbare talen van de zoekmachine en hun language_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      voorbeeld:
      en

    • language_name
      Type: string | null

      volledige naam van de zoekmachinetaal
      optioneel veld
      de lijst met beschikbare talen van de zoekmachine en hun language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      voorbeeld:
      English

    • location_code
      Type: integer | null

      locatiecode van de zoekmachine
      optioneel veld
      als u de locatie niet opgeeft, ontvangt u wereldwijde resultaten, dat wil zeggen voor alle beschikbare locaties;
      als u dit veld gebruikt, hoeft u location_name of location_coordinate niet op te geven;
      de lijst met beschikbare locaties van de zoekmachines en hun location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      voorbeeld:
      2840

    • location_coordinate
      Type: string | null

      GPS-coördinaten van een locatie
      optioneel veld
      als u de locatie niet opgeeft, ontvangt u wereldwijde resultaten, dat wil zeggen voor alle beschikbare locaties;
      als u dit veld gebruikt, hoeft u location_name of location_code niet op te geven;
      de parameter location_coordinate moet in het formaat "latitude,longitude" worden opgegeven;
      de gegevens worden geleverd voor het land waartoe de opgegeven coördinaten behoren;
      voorbeeld:
      52.6178549,-155.352142

    • location_name
      Type: string | null

      volledige naam van de zoekmachinelocatie
      optioneel veld
      als u de locatie niet opgeeft, ontvangt u wereldwijde resultaten, dat wil zeggen voor alle beschikbare locaties;
      als u dit veld gebruikt, hoeft u location_code of location_coordinate niet op te geven
      de lijst met beschikbare locaties van de zoekmachine en hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      voorbeeld:
      London,England,United Kingdom

    • pingback_url
      Type: string | null

      notificatie-URL van een voltooide taak
      optioneel veld
      wanneer een taak is voltooid, stellen we je op de hoogte via een GET-verzoek naar de URL die je hebt opgegeven
      je kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als urlencoded $tag-variabele gebruiken. We stellen de benodigde waarden in voordat het verzoek wordt verzonden
      voorbeeld:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Let op: speciale tekens in pingback_url worden urlencoded;
      het teken # wordt bijvoorbeeld gecodeerd als %23

      meer informatie vind je in ons Help Center

    • postback_url
      Type: string | null

      URL voor het verzenden van taakresultaten
      optioneel veld
      zodra de taak is voltooid, sturen we een POST-verzoek met de resultaten gecomprimeerd in gzip-formaat naar de opgegeven postback_url
      je kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als URL-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen.
      voorbeeld:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Let op: speciale tekens in postback_url worden URL-gecodeerd;
      d.w.z. het teken # wordt gecodeerd als %23

      meer informatie vind je in ons Help Center

    • search_partners
      Type: boolean | null

      Google-zoekpartners opnemen
      optioneel veld
      als u true opgeeft, worden de resultaten geleverd voor eigen, beheerde en gesyndiceerde netwerken op Google- en partnersites die Google Zoeken hosten;
      standaardwaarde: false - resultaten worden geretourneerd voor Google-zoeksites

    • sort_by
      Type: string | null

      sorteerparameters voor resultaten
      optioneel veld
      gebruik deze parameters om de resultaten te sorteren op relevance, search_volume, competition_index, low_top_of_page_bid of high_top_of_page_bid in aflopende volgorde
      standaardwaarde: relevance

    • tag
      Type: string | null

      door gebruiker gedefinieerde taak-ID
      optioneel veld
      de tekenslimiet is 255
      je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
      de opgegeven waarde tag vind je in het data-object van de respons

    • target
      Type: string

      domein of pagina
      verplicht veld
      de domeinnaam van de doelwebsite of de URL van de doelpagina;
      let op: om keywords voor de doelwebsite te verkrijgen, gebruikt u de parameter target_type

    • target_type
      Type: string | null

      keywords zoeken voor site of URL
      optioneel veld
      mogelijke waarden: site, page;
      standaardwaarde: page
      bij site worden keywords voor de hele site geleverd;
      bij page worden keywords voor de opgegeven webpagina geleverd

Responsen
  • 200
    Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsKeywordsForSiteTaskPostResponseInfo
    • cost
      Type: number | null Formaat: double

      Totale kosten van taken, USD

    • status_code
      Type: integer | null

      algemene statuscode de volledige lijst met responscodes vindt u hier

    • status_message
      Type: string | null

      algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

    • tasks
      Type: array (object | null)[] | null

      array van taken

      • Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsKeywordsForSiteTaskPostTaskInfo
        • cost
          Type: number | null Formaat: double

          Totale kosten van taken, USD

        • data
          Type: object | null

          Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

          • propertyName
            Type: object | null
        • id
          Type: string | null

          taak-id eenduidige taak-id in ons systeem in UUID-indeling

        • path
          Type: array (string | null)[] | null

          URL-pad

        • result
          Type: object | null

          array van resultaten
          in dit geval is de waarde null

        • result_count
          Type: integer | null Formaat: int64

          Aantal elementen in de result-array

        • status_code
          Type: integer | null

          statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

        • status_message
          Type: string | null

          informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

        • time
          Type: string | null

          Uitvoeringstijd in seconden

    • tasks_count
      Type: integer | null Formaat: int64

      Het aantal taken in de tasks-array

    • tasks_error
      Type: integer | null Formaat: int64

      Het aantal taken in de tasks-array dat met een fout is geretourneerd

    • time
      Type: string | null

      totale uitvoeringstijd, seconden

    • version
      Type: string | null

      De huidige versie van de API

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

    application/json
Request Example for post/v1/beta/dataforseo/keywords_data/google_ads/keywords_for_site/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/keywords_for_site/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "target": "dataforseo.com"
  }
]'
{
  "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": null
    }
  ]
}
Setting ‘Keywords For Site’ Tasks

Hulp nodig?