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

Domény podle HTML výrazů

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

DataForSEO

​

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

Domény podle HTML výrazů

​

Najde domény, jejichž HTML obsahuje zadané search_terms – jde o surovou shodu řetězce, zatímco post_dataforseo_domains_tech_domains_by_technology_live porovnává zjištěnou technologii. Použijte jej pro sledovací skript, afiliátní značku nebo signaturu šablony, kterou žádný detektor nepojmenuje. Vrací total_count, items_count, offset, offset_token a items se stejným profilem jako vyhledávání technologií.

Cenová reference

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

Tělo
application/json
  • Typ: array (object | null)[]
    • filters
      Typ: array (object | null)[] | null

      pole parametrů pro filtrování výsledků
      volitelné pole
      můžete přidat několik filtrů najednou (maximálně 8 filtrů)
      mezi podmínkami je nutné nastavit logický operátor and, or
      podporované operátory:
      <, <=, >, >=, =, <>, in, not_in, like, not_like
      operátor % můžete použít s like a not_like pro shodu s libovolným řetězcem o nule nebo více znacích
      příklad:
      ["domain","like","%seo%"]

      [["country_iso_code","=","US"],
      "and",
      ["domain_rank",">",100]]

      [["domain_rank",">",100],
      "and",
      [["country_iso_code","=","US"],"or",["country_iso_code","=","CA"]]]

      další informace o filtrech najdete v Domain Analytics Technologies API - Filters

      Prázdný objekt
    • keywords
      Typ: array string[] | null

      cílová klíčová slova v názvu, popisu nebo meta klíčových slovech domény
      volitelné pole
      kódování UTF-8
      maximální počet klíčových slov, která můžete zadat: 10
      příklad:
      ["seo","software"]

      další informace o pravidlech a omezeních polí keyword a keywords v rozhraních DataForSEO najdete v tomto článku nápovědy

    • limit
      Typ: integer | null

      maximální počet vrácených domén
      volitelné pole
      výchozí hodnota: 100
      maximální hodnota: 10000

    • mode
      Typ: string | null

      režim vyhledávání
      volitelné pole
      možné typy režimu vyhledávání:
      strict_entry - vyhledá výsledky přesně odpovídající pořadí, intervalům a oddělovačům v zadaných hledaných výrazech
      entry - vyhledá výsledky bez ohledu na pořadí, intervaly a oddělovače v zadaných hledaných výrazech
      výchozí hodnota: entry

    • offset
      Typ: integer | null

      posun v poli výsledků vrácených domén
      volitelné pole
      výchozí hodnota: 0
      pokud zadáte hodnotu 10, prvních deset domén v poli výsledků se vynechá a data se vrátí pro následující domény;
      Poznámka: maximální hodnota je 9999, součet limit a offset nesmí překročit 10000;
      pokud chcete posunout více výsledků, použijte offset_token

    • offset_token
      Typ: string | null

      token pro následné požadavky
      volitelné pole
      uvádí se ve stejném poli odpovědi na každý požadavek;
      tento parametr použijte, abyste se vyhnuli časovým limitům při snaze získat více než 100 000 výsledků v jednom požadavku;
      zadáním jedinečné hodnoty offset_token z pole odpovědi získáte následné výsledky původní úlohy;
      hodnoty offset_token jsou jedinečné pro každou následnou úlohu
      Poznámka: pokud je v požadavku zadán offset_token, všechny ostatní parametry musí být shodné s předchozím požadavkem
      další informace o tomto parametru najdete v našem centru nápovědy

    • order_by
      Typ: array string[] | null

      pravidla řazení výsledků
      volitelné pole
      dostupná pole:
      domain_rank, domain, last_visited, country_iso_code, language_code, content_language_code
      možné typy řazení:
      asc - výsledky budou seřazeny vzestupně
      desc - výsledky budou seřazeny sestupně
      typ řazení nastavíte čárkou
      příklad:
      ["last_visited,desc"]
      výchozí pravidlo:
      ["domain_rank,desc"]
      mějte na paměti, že v jednom požadavku můžete nastavit nejvýše tři pravidla řazení
      několik pravidel řazení oddělte čárkou
      příklad:
      ["last_visited,desc","domain_rank,desc"]

    • search_terms
      Typ: array string[]

      cílové hledané výrazy
      povinné pole
      zadejte cílové prvky HTML, značky, atributy, jejich obsah nebo všechny tyto možnosti
      pokud zadáte více než jeden hledaný výraz, obdržíte pouze domény obsahující všechny zadané výrazy v kódu HTML své domovské stránky
      maximální počet hledaných výrazů, které můžete zadat: 10
      příklad:
      ["data-attrid"]

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

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

            pole položek

            pole items

            • content_language_code
              Typ: string | null

              jazyk obsahu
              kód jazyka, ve kterém je napsán obsah na cílové doméně

            • country_iso_code
              Typ: string | null

              kód ISO domény
              kód ISO země, do které cílová doména podle určení patří

            • description
              Typ: string | null

              meta popis domény

            • domain
              Typ: string | null

              zadaný název domény

            • domain_rank
              Typ: integer | null

              rank zpětných odkazů cílové domény
              více o této metrice a o tom, jak se počítá, najdete v tomto článku nápovědy

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

              e-maily cíle
              e-maily uvedené na cílovém webu

            • language_code
              Typ: string | null

              jazyk domény
              kód jazyka, se kterým je cílová doména podle určení spojena

            • last_visited
              Typ: string | null

              nejnovější datum, kdy naši crawleři navštívili doménu
              ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
              příklad:
              2022-10-10 12:57:46 +00:00

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

              meta klíčová slova domény

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

              telefonní čísla cíle
              kontaktní telefonní čísla uvedená na cílovém webu

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

              odkazy a uživatelská jména na sociálních sítích
              adresy URL sociálních sítí zjištěné v sociálních grafech cílového webu

            • technologies
              Typ: object | null · Response36Afe1097B20_TechnologiesInfo

              technologie používané cílovou doménou
              obsahuje objekty s názvy technologií používaných na webu;
              úplný seznam technologií a jejich strukturu najdete v endpointu technologies

              • add_ons
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • analytics
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • booking
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • business_tools
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • communication
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • content
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • location
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • marketing
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • media
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • other
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • privacy
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • sales
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • security
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • servers
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • user_generated_content
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • utilities
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
              • web_development
                Typ: object | null
                • propertyName
                  Typ: array (string | null)[] | null
            • title
              Typ: string | null

              meta název domény

            • type
              Typ: string | null

              typ prvku

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

            počet položek v poli výsledků

          • offset
            Typ: integer | null

            zadaná hodnota offsetu

          • offset_token
            Typ: string | null

            token pro následné požadavky
            zadáním jedinečného offset_token při nastavování nové úlohy získáte následující výsledky počáteční úlohy;
            hodnoty offset_token jsou jedinečné pro každou následnou úlohu

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

            celkový počet relevantních položek v databázi

        • 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 post/v1/beta/dataforseo/domain_analytics/technologies/domains_by_html_terms/live
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/domains_by_html_terms/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "search_terms": [
      "data-attrid"
    ],
    "order_by": [
      "last_visited,desc"
    ],
    "limit": 10,
    "offset": 0
  }
]'
{
  "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": [
        {
          "total_count": null,
          "items_count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "type": null,
              "domain": null,
              "title": null,
              "description": null,
              "meta_keywords": [
                "[Max Depth Exceeded]"
              ],
              "domain_rank": null,
              "last_visited": null,
              "country_iso_code": null,
              "language_code": null,
              "content_language_code": null,
              "phone_numbers": [
                "[Max Depth Exceeded]"
              ],
              "emails": [
                "[Max Depth Exceeded]"
              ],
              "social_graph_urls": [
                "[Max Depth Exceeded]"
              ],
              "technologies": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Domains by HTML Terms