v0.2.0-beta

OpenAPI 3.1.0

Konfiguracja zadań Google Jobs

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

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

Konfiguracja zadań Google Jobs

Kolejkuje oferty pracy, które Google pokazuje dla zapytania i zwraca id zadania w tasks[0].id. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wersja na żywo odpowiada natychmiast i jest prostsza przy pojedynczym zapytaniu; kolejkuj, gdy partia trwałaby dłużej niż wywołanie narzędzia.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.02.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej 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)[]
- depth
  Typ: integer | null
  
  głębokość parsowania
  
  pole opcjonalne
  
  liczba wyników w SERP;
  
  wartość domyślna: 10
  
  wartość maksymalna: 200
  
  Twoje konto zostanie rozliczone za każdy SERP zawierający do 10 wyników;
  ustawienie głębokości powyżej 10 może skutkować dodatkowymi opłatami, jeśli wyszukiwarka zwróci więcej niż 10 wyników;
  
  jeśli podana głębokość jest większa niż liczba wyników w odpowiedzi, różnica zostanie automatycznie zwrócona na saldo Twojego konta;
  
  Koszt można obliczyć na stronie Cennik.
- employment_type
  Typ: array string[] | null
  
  typ umowy o pracę
  
  pole opcjonalne
  
  typ umowy o pracę, dla którego mają zostać zwrócone wyniki wyszukiwania;
  
  możliwe wartości:
  
  fulltime, partime, contractor, intern
- keyword
  Typ: string
  
  słowo kluczowe
  
  pole wymagane
  
  w polu keyword można podać do 700 znaków
  
  wszystkie sekwencje %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja)
  
  jeśli w polu keyword potrzebujesz użyć znaku „%”, podaj go jako „%25”;
  
  jeśli potrzebujesz użyć znaku „+” w polu keyword, podaj go jako „%2B”;
  
  Uwaga: podane słowo kluczowe musi wskazywać nazwę stanowiska;
  
  przykład: .net developer
  
  więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach API DataForSEO znajdziesz w tym artykule Centrum pomocy
- language_code
  Typ: string
  
  kod języka wyszukiwarki
  
  pole wymagane, jeśli nie podasz language_name
  
  jeśli używasz tego pola, nie musisz podawać language_name
  
  listę dostępnych języków wyszukiwarki wraz z ich language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/languages
  
  przykład:
  
  en
- language_name
  Typ: string
  
  pełna nazwa języka wyszukiwarki
  
  pole wymagane, jeśli nie podasz language_code
  
  jeśli używasz tego pola, nie musisz podawać language_code;
  
  listę dostępnych języków wyszukiwarki wraz z ich language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/languages
  
  przykład:
  
  English
- location_code
  Typ: integer
  
  kod lokalizacji wyszukiwarki
  
  pole wymagane, jeśli nie podasz 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/serp/google/jobs/locations
  
  przykład:
  
  2840
- location_name
  Typ: string
  
  pełna nazwa lokalizacji wyszukiwarki
  
  pole wymagane, jeśli nie podasz location_code
  
  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/serp/google/jobs/locations
  
  przykład:
  
  London,England,United Kingdom
- location_radius
  Typ: string | null
  
  promień wyszukiwania lokalizacji
  
  pole opcjonalne
  
  promień wyszukiwania lokalizacji w kilometrach;
  
  Uwaga: w krajach stosujących imperialny system miar musisz przeliczyć mile na kilometry, mnożąc wartość w milach przez 1.609;
  
  jeśli wartość nie jest podana, wyszukiwanie odbywa się w dowolnym miejscu w obrębie podanej lokalizacji;
  
  wartość maksymalna: 300
  
  wartość minimalna: > 0
- pingback_url
  Typ: string | null
  
  adres URL powiadomienia o zakończonym zadaniu
  
  pole opcjonalne
  
  po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
  
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  
  przykład:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
  
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji w naszym Centrum pomocy
- postback_data
  Typ: string
  
  typ danych postback_url
  
  pole wymagane, jeśli podasz postback_url
  
  odpowiada typowi danych, który zostanie wysłany na Twój serwer
  
  możliwe wartości:
  
  regular, advanced, html
- postback_url
  Typ: string | null
  
  adres URL do wysyłania wyników zadania
  
  pole opcjonalne
  
  po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
  
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  
  przykład:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
  
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- priority
  Typ: integer | null
  
  priorytet zadania
  
  pole opcjonalne
  
  może przyjmować następujące wartości:
  
  1 – normalny priorytet wykonania (ustawiany domyślnie)
  
  2 – wysoki priorytet wykonania
  
  Za zadania o wysokim priorytecie wykonania zostanie naliczona dodatkowa opłata.
  Koszt można obliczyć na stronie Cennik.
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  
  pole opcjonalne
  
  limit znaków to 255
  
  możesz użyć tego parametru, aby zidentyfikować zadanie i dopasować je do wyniku
  
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_SerpGoogleJobsTaskPostResponseInfo
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_SerpGoogleJobsTaskPostTaskInfo
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: object | null

tablica wyników
w tym przypadku wartością będzie null

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/jobs/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": ".net developer"
  },
  {
    "language_name": "English",
    "location_name": "United States",
    "keyword": ".net developer",
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

Pokaż schemat

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

Operacja zakończona powodzeniem

Konfiguracja zadań Google Jobs

UwierzytelnianieRequired

DataForSEO

Konfiguracja zadań Google Jobs

Cennik referencyjny