Felo API PlatformFelo API Platform
Wszystkie endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tworzenie zadań live ‘DataForSEO Trends Explore’

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

DataForSEO

​

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

DataForSEO Operacje

Tworzenie zadań live ‘DataForSEO Trends Explore’

​

Zainteresowanie w czasie dla maksymalnie pięciu keywords — krzywa Google Trends. Zwraca keywords, type, location_code, language_code, datetime, items_count i items. type wybiera web, news, images, youtube lub shopping, a date_from/date_to wyznaczają przedział czasu. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Trends podaje zainteresowanie względne, a nie bezwzględny wolumen; do liczb użyj post_dataforseo_keywords_gads_search_volume_live.

Cennik referencyjny

  • Rozliczanie: zgłoszony koszt odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.0012.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej już kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
application/json
  • Typ: array (object | null)[]
    • date_from
      Typ: string | null

      data początkowa zakresu czasu
      pole opcjonalne
      jeśli nie podasz tego pola, domyślnie zostanie użyty bieżący dzień i miesiąc poprzedniego roku
      wartość minimalna dla typu web: 2004-01-01
      wartość minimalna dla pozostałych typów: 2008-01-01
      format daty: "yyyy-mm-dd"
      przykład:
      "2019-01-15"

    • date_to
      Typ: string | null

      data końcowa zakresu czasu
      pole opcjonalne
      jeśli nie podasz tego pola, domyślnie zostanie użyta dzisiejsza data
      format daty: "yyyy-mm-dd"
      przykład:
      "2019-01-15"

    • keywords
      Typ: array string[]

      słowa kluczowe
      pole wymagane
      maksymalna liczba słów kluczowych, które możesz podać: 5

      więcej o regułach i ograniczeniach pól keyword i keywords w interfejsach DataForSEO przeczytasz w tym artykule Centrum pomocy

    • location_code
      Typ: integer | null

      kod lokalizacji wyszukiwarki
      pole opcjonalne
      jeśli nie użyjesz tego pola, otrzymasz wyniki globalne
      jeśli używasz tego pola, nie musisz podawać location_name
      listę dostępnych lokalizacji wyszukiwarek wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      pamiętaj, że dane zostaną podane dla kraju, do którego należy podany location_code;
      przykład:
      2840

    • location_name
      Typ: string | null

      pełna nazwa lokalizacji wyszukiwarki
      pole opcjonalne
      jeśli nie użyjesz tego pola, otrzymasz wyniki globalne
      jeśli używasz tego pola, nie musisz podawać location_code
      listę dostępnych lokalizacji wyszukiwarki wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      pamiętaj, że dane zostaną podane dla kraju, do którego należy podana location_name;
      przykład:
      United Kingdom

    • tag
      Typ: string | null

      identyfikator zadania zdefiniowany przez użytkownika
      pole opcjonalne
      limit znaków: 255
      ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
      podaną wartość tag znajdziesz w obiekcie data odpowiedzi

    • time_range
      Typ: string | null

      wstępnie ustawione zakresy czasu
      pole opcjonalne
      jeśli podasz parametry date_from lub date_to, to pole zostanie zignorowane podczas ustawiania zadania
      możliwe wartości dla wszystkich parametrów type:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      Typ: string | null

      typ elementu

Odpowiedzi
  • 200
    Typ: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsExploreLiveResponseInfo
    • cost
      Typ: number | null Format: double

      łączny koszt zadań, USD

    • status_code
      Typ: integer | null

      ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

    • status_message
      Typ: string | null

      ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

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

      tablica zadań

      • Typ: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsExploreLiveTaskInfo
        • cost
          Typ: number | null Format: double

          łączny koszt zadań, USD

        • data
          Typ: object | null

          zawiera te same parametry, które podano w żądaniu POST

          • propertyName
            Typ: object | null
        • id
          Typ: string | null

          identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

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

          ścieżka URL

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

          tablica wyników

          • datetime
            Typ: string | null

            data i godzina otrzymania wyniku
            w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
            przykład:
            2019-11-15 12:57:46 +00:00

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

            zawiera popularność słów kluczowych i powiązane dane

            • Typ: object | null · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                • Typ: object · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                  • type
                    Dyskryminator
                    Typ: string | null

                    typ elementu

                  • averages
                    Typ: array (integer | null)[] | null
                  • data
                    Typ: array (object | null)[] | null

                    zawiera te same parametry, które podano w żądaniu POST

                    • date_from
                      Typ: string | null

                      data początkowa odpowiedniego zakresu czasu
                      w formacie UTC: „yyyy-mm-dd”

                    • date_to
                      Typ: string | null

                      data końcowa odpowiedniego zakresu czasu
                      w formacie UTC: „yyyy-mm-dd”

                    • timestamp
                      Typ: integer | null

                      punkt w czasie w formacie czasu Unix

                    • values
                      Typ: array (integer | null)[] | null

                      względny wskaźnik popularności słowa kluczowego w określonym znaczniku czasu
                      przedstawia wskaźnik popularności słowa kluczowego w danym zakresie czasu
                      jeśli podasz więcej niż jedno słowo kluczowe, wartości zostaną uśrednione do najwyższej wartości spośród wszystkich podanych słów kluczowych
                      wartość 100 oznacza szczyt popularności terminu. Wartość 50 oznacza, że termin jest o połowę mniej popularny. Wynik 0 oznacza, że dla tego terminu było za mało danych

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

                    słowa kluczowe w tablicy POST

                  • position
                    Typ: integer | null

                    wyrównanie elementu
                    może przyjmować następujące wartości: 1, 2, 3, 4 itd.

          • items_count
            Typ: integer | null Format: int64

            liczba wyników zwróconych w tablicy items

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

            słowa kluczowe w tablicy POST

          • language_code
            Typ: string | null

            kod języka w tablicy POST
            jeśli brak danych, wartością jest null

          • location_code
            Typ: integer | null

            kod lokalizacji w tablicy POST
            jeśli brak danych, wartością jest null

          • type
            Typ: string | null

            typ elementu

        • result_count
          Typ: integer | null Format: int64

          liczba elementów w tablicy result

        • status_code
          Typ: integer | null

          kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

        • status_message
          Typ: string | null

          komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

        • time
          Typ: string | null

          czas wykonania, sekundy

    • tasks_count
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks

    • tasks_error
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks zwróconych z błędem

    • time
      Typ: string | null

      łączny czas wykonania, sekundy

    • version
      Typ: string | null

      bieżąca wersja interfejsu API

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    application/json
Request Example for post/v1/beta/dataforseo/keywords_data/dataforseo_trends/explore/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/explore/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "iphone 14",
      "samsung s23"
    ],
    "location_code": 2840
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "data": "[Max Depth Exceeded]",
              "averages": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Setting Live ‘DataForSEO Trends Explore’ Tasks