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

Taken voor Google Events SERP instellen

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

DataForSEO

​

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

Taken voor Google Events SERP instellen

​

Zet de evenementen die Google voor een zoekopdracht toont in de wachtrij en retourneert een taak-id in tasks[0].id. Verpakt in de DataForSEO-envelop: gegevens in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. De live-tweeling antwoordt onmiddellijk en is eenvoudiger voor één query; gebruik de wachtrij wanneer de batch langer duurt dan een toolaanroep.

Prijsreferentie

  • Afrekening: gerapporteerde responskosten.
  • Referentieschatting per verzoek: USD 0.02.
  • 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
verplicht
application/json
  • Type: array object[]
    • keyword
      Type: string
      verplicht

      Keyword om naar te zoeken

    • language_code
      Type: string

      Taalcode van de zoekmachine

    • language_name
      Type: string

      Volledige naam van de taal van de zoekmachine

    • location_code
      Type: integer

      Locatiecode van de zoekmachine

    • location_coordinate
      Type: string

      GPS-coördinaten van een locatie

    • location_name
      Type: string

      Volledige naam van de locatie van de zoekmachine

    • pingback_url
      Type: string

      Meldings-URL van een voltooide taak

    • postback_data
      Type: string

      Postback-gegevenstype

    • postback_url
      Type: string

      URL voor het verzenden van taakresultaten

    • priority
      Type: integer

      Taakprioriteit

Responsen
  • 200
    Type: object

    Geslaagde respons

    • cost
      Type: number

      Totale kosten van taken, USD

    • status_code
      Type: integer

      Algemene statuscode

    • status_message
      Type: string

      Algemene informatieve melding

    • tasks
      Type: array string[]

      Array met taakobjecten

    • tasks_count
      Type: integer

      Het aantal taken in de tasksarray

    • tasks_error
      Type: integer

      Het aantal taken in de tasksarray dat met een fout is geretourneerd

    • tasks[].cost
      Type: number

      Kosten van de taak, USD

    • tasks[].id
      Type: string

      Taakidentificatie in UUID-indeling

    • tasks[].result_count
      Type: integer

      Aantal elementen in de resultatenarray

    • tasks[].status_code
      Type: integer

      Statuscode van de taak

    • tasks[].status_message
      Type: string

      Statusbericht van de taak

    • time
      Type: string

      Uitvoeringstijd, seconden

    • version
      Type: string

      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/serp/google/events/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/events/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "",
    "location_code": 1,
    "location_name": "",
    "location_coordinate": "",
    "language_code": "",
    "language_name": "",
    "priority": 1,
    "postback_url": "",
    "pingback_url": "",
    "postback_data": ""
  }
]'
{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks[].id": "string",
  "tasks[].status_code": 1,
  "tasks[].status_message": "string",
  "tasks[].cost": 1,
  "tasks[].result_count": 1
}
Setting Google Events SERP Tasks