v0.2.0-beta

OpenAPI 3.1.0

Google Maps SERP-taken instellen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operaties

post/v1/beta/dataforseo/serp/google/maps/task_post

Google Maps SERP-taken instellen

Zet het map pack voor een lokale zoekopdracht met de beoordeling, het adres en de place-id van elk bedrijf op Google in de wachtrij en retourneert een taak-id in tasks[0].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 live-tweelingbroertje antwoordt direct en is eenvoudiger voor één query; gebruik de wachtrij wanneer de batch langer duurt dan een tool-aanroep.

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

application/json

Type: array (object | null)[]
- depth
  Type: integer | null
  
  parseerdiepte
  
  optioneel veld
  
  aantal resultaten in de SERP
  
  standaardwaarde: 100
  
  maximumwaarde: 700
  
  je account wordt gefactureerd per SERP met maximaal 100 resultaten;
  een diepte boven 100 kan extra kosten veroorzaken als de zoekmachine meer dan 100 resultaten retourneert;
  
  de kosten kunnen worden berekend op de pagina Pricing.
- device
  Type: string | null
  
  apparaattype
  
  optioneel veld
  
  resultaten voor een bepaald apparaattype retourneren
  
  kan de waarden aannemen:desktop, mobile
  
  standaardwaarde: desktop
  
  let op: voor mobile worden per SERP slechts 20 resultaten geretourneerd
- keyword
  Type: string
  
  keyword
  
  verplicht veld
  
  je kunt maximaal 700 tekens in het veld keyword opgeven
  
  alle %## worden gedecodeerd (het teken ‘+’ wordt bovendien gedecodeerd naar een spatie)
  
  als je het teken “%” voor je keyword wilt gebruiken, geef het op als “%25”;
  
  als je het teken “+” voor je keyword wilt gebruiken, geef het op als “%2B”;
  
  meer informatie over regels en beperkingen van de velden keyword en keywords in DataForSEO-API's vind je in dit Help Center-artikel
- language_code
  Type: string
  
  taalcode van de zoekmachine
  
  verplicht veld als niet opgegeven language_name
  
  bij gebruik van dit veld hoef je language_name niet op te geven
  
  je kunt de lijst met beschikbare talen van de zoekmachine met hun language_code opvragen via een apart verzoek aan de https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  voorbeeld:
  
  en
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  
  verplicht veld als niet opgegeven language_code
  
  bij gebruik van dit veld hoef je language_code niet op te geven
  
  je kunt de lijst met beschikbare talen van de zoekmachine met hun language_name opvragen via een apart verzoek aan de https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  voorbeeld:
  
  English
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  
  verplicht veld als niet opgegeven location_name of location_coordinate
  
  bij gebruik van dit veld hoef je location_name of location_coordinate niet op te geven
  
  je kunt de lijst met beschikbare locaties van de zoekmachines met hun location_code opvragen via een apart verzoek aan de https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  voorbeeld:
  
  2840
- location_coordinate
  Type: string
  
  GPS-coördinaten van een locatie
  
  verplicht veld als niet opgegeven location_name of location_code
  
  bij gebruik van dit veld hoef je location_name of location_code niet op te geven
  
  de parameter location_coordinate moet in het formaat "latitude,longitude,zoom" worden opgegeven
  
  als "zoom" niet is opgegeven, wordt 17z als standaardwaarde gebruikt
  
  het maximale aantal decimalen voor "latitude" en "longitude": 7
  
  de minimumwaarde voor "zoom": 3z
  
  de maximumwaarde voor "zoom": 21z
  
  voorbeeld:
  
  52.6178549,-155.352142,20z
- location_name
  Type: string
  
  volledige naam van de locatie van de zoekmachine
  
  verplicht veld als u niet opgeeft location_code of location_coordinate
  
  als u dit veld gebruikt, hoeft u location_code of location_coordinate niet op te geven
  
  de lijst met beschikbare locaties van de zoekmachine met hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  voorbeeld:
  
  London,England,United Kingdom
- max_crawl_pages
  Type: integer | null
  
  crawllimiet voor pagina's
  
  optioneel veld
  
  aantal te crawlen pagina's met zoekresultaten
  
  maximumwaarde: 100
  
  Let op: de parameters max_crawl_pages en depth vullen elkaar aan;
  
  meer informatie vindt u in ons Help Center
- os
  Type: string | null
  
  besturingssysteem van het apparaat
  
  optioneel veld
  
  als u desktop in het veld device opgeeft, kiest u uit de volgende waarden: windows, macos
  
  standaardwaarde: windows
  
  als u mobile in het veld device opgeeft, kiest u uit de volgende waarden: android, ios
  
  standaardwaarde: android
- pingback_url
  Type: string | null
  
  meldings-URL van een voltooide taak
  
  optioneel veld
  
  wanneer een taak is voltooid, melden we u dit via een GET-verzoek naar de URL die u hebt opgegeven
  
  u 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/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Let op: speciale tekens in pingback_url worden URL-gecodeerd;
  
  d.w.z. het teken # wordt gecodeerd als %23
  
  meer informatie vindt u in ons Help Center
- postback_data
  Type: string
  
  postback_url-datatype
  
  verplicht veld als u postback_url opgeeft
  
  komt overeen met de functie die u hebt gebruikt om een taak in te stellen
  
  mogelijke waarden:
  
  advanced
- postback_url
  Type: string | null
  
  URL voor het verzenden van taakresultaten
  
  optioneel veld
  
  wanneer een 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;
  
  zo wordt het teken # gecodeerd als %23
  
  meer informatie vind je in ons Help Center
- priority
  Type: integer | null
  
  taakprioriteit
  
  optioneel veld
  
  kan de volgende waarden hebben:
  
  1 – normale uitvoeringsprioriteit (standaard ingesteld)
  
  2 – hoge uitvoeringsprioriteit
  
  Voor taken met hoge uitvoeringsprioriteit worden extra kosten in rekening gebracht.
  de kosten kunnen worden berekend op de pagina Pricing.
- se_domain
  Type: string | null
  
  zoekmachinedomein
  
  optioneel veld
  
  we kiezen het relevante zoekmachinedomein automatisch op basis van de locatie en taal die u opgeeft
  
  u kunt in dit veld echter een aangepast zoekmachinedomein instellen
  
  voorbeeld:
  
  google.co.uk
- search_places
  Type: boolean | null
  
  modus voor zoeklocaties
  
  optioneel veld
  
  met de modus voor zoeklocaties kunt u Google Maps-resultaten voor een bepaalde locatie verkrijgen (bijv. Apple Store in New York)
  
  vanwege de eigenaardigheden van ons datamining-algoritme kan deze modus echter interfereren met sommige query's met lokale intentie - en resultaten weergeven voor een andere locatie dan die in het verzoek is opgegeven;
  
  om deze interferentie te voorkomen en correcte resultaten te verkrijgen voor keywords met lokale intentie, kunt u deze parameter op false instellen;standaardwaarde: true
  
  Let op: als de modus search_places is uitgeschakeld en er geen resultaten zijn gevonden in het zoekgebied, is de array results leeg
- search_this_area
  Type: boolean | null
  
  resultaten uit het weergegeven gebied tonen
  
  optioneel veld
  
  kan de waarden aannemen:true, false
  
  standaardwaarde: true
  
  bij instelling op false wordt de modus search_this_area uitgeschakeld
  
  Let op: als de modus search_this_area is uitgeschakeld, kunnen Google Maps-vermeldingen resultaten buiten het weergegeven gebied bevatten
- tag
  Type: string | null
  
  door gebruiker gedefinieerde taakidentificatie
  
  optioneel veld
  
  de tekenlimiet is 255
  
  u kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
  
  u vindt de opgegeven tag-waarde in het data-object van de respons
- url
  Type: string | null
  
  directe URL van de zoekopdracht
  
  optioneel veld
  
  u kunt een directe URL opgeven en wij sorteren deze uit naar de benodigde velden. Houd er rekening mee dat deze methode het moeilijkst is voor onze API om te verwerken en dat u de exacte taal en locatie in de URL moet opgeven. In de meeste gevallen raden we deze methode niet aan.
  
  voorbeeld:
  
  https://google.com/maps/search/pizza/@37.09024,-95.712891,4z
  
  Let op: de volgende zoekmachineparameters worden niet ondersteund en worden automatisch uitgeschakeld als ze in de URL worden opgegeven: allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.

Responsen

200
Type: object | null · Response36Afe1097B20_SerpGoogleMapsTaskPostResponseInfo
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_SerpGoogleMapsTaskPostTaskInfo
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

post/v1/beta/dataforseo/serp/google/maps/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/maps/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

Schema tonen

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

Geslaagde bewerking

Google Maps SERP-taken instellen

AuthenticatieRequired

DataForSEO

Google Maps SERP-taken instellen

Prijsreferentie