v0.2.0-beta

OpenAPI 3.1.0

Google My Business-vragen en -antwoorden: taak indienen

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/business_data/google/questions_and_answers/live

Google My Business-vragen en -antwoorden: taak indienen

De vragen en antwoorden bij een Google-bedrijfsprofiel, gevonden via keyword en location_code. Retourneert keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id en item_types. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.2428.
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
  
  parsediepte
  optioneel veld
  aantal resultaten in de SERP
  standaardwaarde: 20
  maximale waarde: 100
  uw account wordt gefactureerd per SERP met maximaal 20 resultaten;
  een diepte boven 20 kan extra kosten opleveren als de zoekmachine meer dan 20 resultaten retourneert;
  als de opgegeven diepte hoger is dan het aantal vragen in de respons, wordt het verschil automatisch aan uw accountsaldo terugbetaald;
  de kosten kunt u berekenen op de pagina Pricing.
- keyword
  Type: string
  
  keyword
  verplicht veld
  het opgegeven keyword moet de naam van de lokale vestiging aanduiden
  u kunt maximaal 700 tekens in het veld keyword opgeven
  alle %## worden gedecodeerd (het teken ‘+’ wordt daarbij gedecodeerd naar een spatie)
  als u het teken “%” in uw keyword wilt gebruiken, geeft u het op als “%25”;
  
  dit veld kan ook worden gebruikt om de volgende parameters door te geven:
  cid - een unieke, door Google gedefinieerde id van de bedrijfsentiteit;
  place_id - een identificatie van de bedrijfsentiteit in Google Maps;
  
  voorbeeld:
  cid:194604053573767737
  place_id:GhIJQWDl0CIeQUARxks3icF8U8A
  
  lees meer over de identificaties cid en place_id in dit Help Center-artikel
  
  lees meer over regels en beperkingen van de velden keyword en keywords in DataForSEO-API's in dit Help Center-artikel
- language_code
  Type: string
  
  taalcode van de zoekmachine
  verplicht veld als u language_name niet opgeeft
  als u dit veld gebruikt, hoeft u language_name niet op te geven
  de lijst met beschikbare talen van de zoekmachine en hun language_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/google/languages
  voorbeeld:
  en
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  verplicht veld als u language_code niet opgeeft
  als u dit veld gebruikt, hoeft u language_code niet op te geven
  de lijst met beschikbare talen van de zoekmachine en hun language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/google/languages
  voorbeeld:
  English
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  verplicht veld als u location_name of location_coordinate niet opgeeft
  als u dit veld gebruikt, hoeft u location_name of location_coordinate niet op te geven
  de lijst met beschikbare locaties met location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/google/locations
  voorbeeld:
  2840
- location_coordinate
  Type: string
  
  GPS-coördinaten van een locatie
  verplicht veld als u location_name of location_code niet opgeeft
  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,radius" worden opgegeven
  het maximale aantal decimalen voor "latitude" en "longitude": 7
  de minimale waarde voor "radius": 199.9 (mm)
  de maximale waarde voor "radius": 199999 (mm)
  voorbeeld:
  53.476225,-2.243572,200
- location_name
  Type: string
  
  volledige naam van de locatie van de zoekmachine
  verplicht veld als u location_code of location_coordinate niet opgeeft
  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/business_data/google/locations
  voorbeeld:
  London,England,United Kingdom
- 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

Responsen

200
Type: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo
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_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
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: array (object | null)[] | null

array van resultaten

check_url
Type: string | null

directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we nauwkeurige resultaten hebben geleverd

cid
Type: string | null

door Google gedefinieerde client-id
unieke id van een lokale vestiging;
lees meer over de id in dit Help Center-artikel

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

feature_id
Type: string | null

unieke id van de SERP-functie

item_types
Type: array (string | null)[] | null

itemtypen
typen zoekresultaten die in de array items voorkomen;
mogelijke itemtypen: google_business_question_item

items
Type: array (object | null)[] | null

array van items
items binnen google_business_question_item

items
Type: array (object | null)[] | null

array van items
items binnen google_business_question_item

answer_id
Type: string | null

id van het antwoord

answer_text
Type: string | null

huidige tekst van het antwoord

original_answer_text
Type: string | null

oorspronkelijke tekst van het antwoord

profile_image_url
Type: string | null

URL van de profielafbeelding van de gebruiker

profile_name
Type: string | null

weergegeven naam van de gebruiker

profile_url
Type: string | null

URL van het profiel van de gebruiker

time_ago
Type: string | null

geschatte tijd waarop het antwoord is geplaatst

timestamp
Type: string | null

exacte tijd waarop het antwoord is geplaatst

type
Type: string | null

elementtype

original_question_text
Type: string | null

oorspronkelijke tekst van de vraag

profile_image_url
Type: string | null

URL van de profielafbeelding van de gebruiker

profile_name
Type: string | null

weergegeven naam van de gebruiker

profile_url
Type: string | null

URL van het profiel van de gebruiker

question_id
Type: string | null

ID van de vraag

question_text
Type: string | null

huidige tekst van de vraag

rank_absolute
Type: integer | null

absolute rang onder alle elementen

rank_group
Type: integer | null

positie binnen een groep elementen met identieke type-waarden
posities van elementen met verschillende type-waarden worden weggelaten uit rank_group

time_ago
Type: string | null

geschatte tijd waarop de vraag is geplaatst

timestamp
Type: string | null

exacte tijd waarop de vraag is geplaatst

type
Type: string | null

elementtype

url
Type: string | null

URL van de vraag

items_count
Type: integer | null Formaat: int64

het aantal items in de array items

items_without_answers
Type: array (object | null)[] | null

array met Google-bedrijfsvraagitems zonder antwoorden

items
Type: array (object | null)[] | null

array van items
items binnen google_business_question_item

answer_id
Type: string | null

id van het antwoord

answer_text
Type: string | null

huidige tekst van het antwoord

original_answer_text
Type: string | null

oorspronkelijke tekst van het antwoord

profile_image_url
Type: string | null

URL van de profielafbeelding van de gebruiker

profile_name
Type: string | null

weergegeven naam van de gebruiker

profile_url
Type: string | null

URL van het profiel van de gebruiker

time_ago
Type: string | null

geschatte tijd waarop het antwoord is geplaatst

timestamp
Type: string | null

exacte tijd waarop het antwoord is geplaatst

type
Type: string | null

elementtype

original_question_text
Type: string | null

oorspronkelijke tekst van de vraag

profile_image_url
Type: string | null

URL van de profielafbeelding van de gebruiker

profile_name
Type: string | null

weergegeven naam van de gebruiker

profile_url
Type: string | null

URL van het profiel van de gebruiker

question_id
Type: string | null

ID van de vraag

question_text
Type: string | null

huidige tekst van de vraag

rank_absolute
Type: integer | null

absolute rang onder alle elementen

rank_group
Type: integer | null

positie binnen een groep elementen met identieke type-waarden
posities van elementen met verschillende type-waarden worden weggelaten uit rank_group

time_ago
Type: string | null

geschatte tijd waarop de vraag is geplaatst

timestamp
Type: string | null

exacte tijd waarop de vraag is geplaatst

type
Type: string | null

elementtype

url
Type: string | null

URL van de vraag

keyword
Type: string | null

keyword ontvangen in een POST-array
het keyword wordt gedecodeerd geretourneerd (%##; het plusteken '+' wordt gedecodeerd naar een spatie)
dit veld bevat de parameter cid als u deze bij het instellen van een taak in het veld keyword hebt opgegeven;
voorbeeld:
cid:2946633002421908862
lees meer over de parameter in dit Help Center-artikel

language_code
Type: string | null

taalcode in een POST-array

location_code
Type: integer | null

locatiecode in een POST-array

se_domain
Type: string | null

zoekmachinedomein zoals opgegeven in een POST-array

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/business_data/google/questions_and_answers/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

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": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_without_answers": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Google My Business-vragen en -antwoorden: taak indienen

AuthenticatieRequired

DataForSEO

Google My Business-vragen en -antwoorden: taak indienen

Prijsreferentie