Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Získání pokročilých výsledků SERP Google Local Finder podle id

Server:https://openapi.felo.ai
Klientské knihovny

DataForSEO

​

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

Získání pokročilých výsledků SERP Google Local Finder podle id

​

Načte zařazený výsledek místního vyhledávání Google podle id. Vrací keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count a items. 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.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.02.
  • 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.

Parametry cesty
  • id
    Typ: string
    povinné

    identifikátor úlohy
    univerzálně jedinečný identifikátor (UUID)
    jedinečný identifikátor úlohy v našem systému
    můžete jej po dobu 30 dní kdykoli použít k vyžádání výsledků úlohy

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_SerpGoogleLocalFinderTaskGetAdvancedResponseInfo
    • 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_SerpGoogleLocalFinderTaskGetAdvancedTaskInfo
        • 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ů

          • check_url
            Typ: string | null

            přímá adresa URL na výsledky vyhledávače
            můžete ji použít k ověření, že jsme poskytli přesné výsledky

          • datetime
            Typ: string | null

            datum a čas přijetí výsledku
            ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
            příklad:
            2019-11-15 12:57:46 +00:00

          • item_types
            Typ: array (string | null)[] | null

            typy výsledků vyhledávání v SERP
            obsahuje typy výsledků vyhledávání (items) nalezených v SERP.
            možné typy položek:
            local_pack

          • items
            Typ: array (object | null)[] | null

            položky prvku

            • Typ: object | null · Response36Afe1097B20_LocalPackSerpElementItem
                • Typ: object · Response36Afe1097B20_LocalPackSerpElementItem
                  • type
                    Diskriminátor
                    Typ: string | null

                    typ prvku

                  • booking_url
                    Typ: string | null

                    URL rezervační stránky

                  • cid
                    Typ: string | null

                    identifikátor klienta definovaný Googlem

                  • description
                    Typ: string | null

                    popis odkazu

                  • domain
                    Typ: string | null

                    doména webu, který hostuje video

                  • is_paid
                    Typ: boolean | null

                    udává, zda je prvek reklamou

                  • page
                    Typ: integer | null

                    číslo stránky výsledků vyhledávání
                    udává číslo stránky SERP, na které se prvek nachází

                  • phone
                    Typ: string | null

                    telefonní číslo

                  • position
                    Typ: string | null

                    zarovnání prvku v SERP
                    může nabývat následujících hodnot:
                    left, right

                  • rank_absolute
                    Typ: integer | null

                    absolutní pořadí v SERP
                    absolutní pozice mezi všemi prvky v SERP
                    vždy se rovná 0 pro desktop

                  • rank_group
                    Typ: integer | null

                    pořadí ve skupině v SERP
                    pozice ve skupině prvků se shodnými hodnotami type;
                    pozice prvků s odlišnými hodnotami type se v rank_group vynechávají;
                    vždy se rovná 0 pro desktop

                  • rating
                    Typ: object | null · Response36Afe1097B20_RatingInfo

                    hodnocení prvku
                    míra popularity založená na recenzích a zobrazená v SERP;
                    pokud žádná není, je null

                    • rating_max
                      Typ: integer | null

                      maximální hodnota pro rating_type

                    • rating_type
                      Typ: string | null

                      typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax

                    • value
                      Typ: number | null Formát: double

                      hodnota hodnocení

                    • votes_count
                      Typ: integer | null Formát: int64

                      množství zpětné vazby

                  • rectangle
                    Typ: object | null · Response36Afe1097B20_AiModeRectangleInfo

                    parametry obdélníku
                    obsahuje kartézské souřadnice a rozměry v pixelech úryvku výsledku v SERP
                    rovná se null, pokud calculate_rectangles v požadavku POST není nastaveno na true

                    • height
                      Typ: number | null Formát: double

                      výška prvku v pixelech

                    • width
                      Typ: number | null Formát: double

                      šířka prvku v pixelech

                    • x
                      Typ: number | null Formát: double

                      souřadnice osy x souřadnice osy x levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky

                    • y
                      Typ: number | null Formát: double

                      souřadnice osy y souřadnice osy y levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky

                  • title
                    Typ: string | null

                    název řádku

                  • url
                    Typ: string | null

                    adresa URL zdroje recenzí třetí strany

                  • xpath
                    Typ: string | null

                    XPath prvku

          • items_count
            Typ: integer | null Formát: int64

            počet výsledků vrácených v poli items

          • keyword
            Typ: string | null

            klíčové slovo přijaté v poli POST
            klíčové slovo se vrací s dekódovaným %## (symbol „+” bude dekódován na znak mezery)

          • language_code
            Typ: string | null

            kód jazyka v poli POST

          • location_code
            Typ: integer | null

            kód lokality v poli POST

          • refinement_chips
            Typ: object | null · Response36Afe1097B20_RefinementChipsInfo

            čipy pro upřesnění vyhledávání

            • items
              Typ: array (object | null)[] | null

              položky prvku

              • domain
                Typ: string | null

                doména v SERP

              • options
                Typ: array (object | null)[] | null

                další možnosti upřesnění vyhledávání

                • domain
                  Typ: string | null

                  doména v SERP

                • title
                  Typ: string | null

                  název prvku

                • type
                  Typ: string | null

                  typ prvku

                • url
                  Typ: string | null

                  URL vyhledávání s parametry upřesnění

              • title
                Typ: string | null

                název prvku

              • type
                Typ: string | null

                typ prvku

              • url
                Typ: string | null

                URL vyhledávání s parametry upřesnění

            • type
              Typ: string | null

              typ prvku

            • xpath
              Typ: string | null

              XPath prvku

          • se_domain
            Typ: string | null

            doména vyhledávače v poli POST

          • se_results_count
            Typ: integer | null Formát: int64

            celkový počet výsledků v SERP

          • spell
            Typ: object | null · Response36Afe1097B20_SpellInfo

            automatická oprava vyhledávače
            pokud vyhledávač poskytl výsledky pro opravené klíčové slovo, uvedeme klíčové slovo opravené vyhledávačem a typ automatické opravy

            • keyword
              Typ: string | null

              klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo

            • type
              Typ: string | null

              typ automatické opravy možné hodnoty: did_you_mean, showing_results_for, no_results_found_for, including_results_for poznámka: Yahoo a Yandex podporují pouze následující typ automatické opravy: including_results_for

          • type
            Typ: string | null

            typ prvku

        • 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
Request Example for get/v1/beta/dataforseo/serp/google/local_finder/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Get Google Local Finder SERP Advanced Results by id