v0.2.0-beta

OpenAPI 3.1.0

Zadania wyszukiwania lokalnych wizytówek firm na żywo

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/business_data/business_listings/search/live

Zadania wyszukiwania lokalnych wizytówek firm na żywo

Przeszukuje własny indeks lokalnych wizytówek firm DataForSEO według categories, description, title i location_coordinate — trójki: szerokość, długość i promień. Zwraca total_count, count, offset, offset_token i items, stronicowane tokenem. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. To zapytanie do indeksu z natychmiastową odpowiedzią; wszystko pozostałe w tej części zleca świeże pobranie źródła. Zacznij tutaj, a schodź głębiej tylko tam, gdzie to potrzebne.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.2428.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie oferta dla konta, nie gwarantowana cena ani 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)[]
- categories
  Typ: array string[] | null
  
  kategorie firm
  pole opcjonalne
  podane kategorie są używane do wyszukiwania wizytówek firm;
  jeśli nie użyjesz tego pola, zwrócimy wizytówki firm znalezione w podanej lokalizacji;
  możesz podać do 10 kategorii
- description
  Typ: string | null
  
  opis elementu w SERP
  pole opcjonalne
  opis podmiotu gospodarczego, dla którego zbierane są wyniki;
  może zawierać do 200 znaków
- filters
  Typ: array (object | null)[] | null
  
  tablica parametrów filtrowania wyników
  pole opcjonalne
  możesz dodać kilka filtrów jednocześnie (maksymalnie 8)
  między warunkami należy ustawić operator logiczny and, or
  obsługiwane są następujące operatory:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  operatora % możesz użyć z like i not_like, aby dopasować dowolny ciąg złożony z zera lub więcej znaków
  przykład:
  ["rating.value",">",3]
  listę dostępnych filtrów możesz otrzymać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/business_listings/available_filters
  Pełna lista możliwych filtrów jest dostępna tutaj.
  
  Pusty obiekt
- is_claimed
  Typ: boolean | null
  
  wskazuje, czy firma została zweryfikowana przez właściciela w Google Maps
  pole opcjonalne
- limit
  Typ: integer | null
  
  maksymalna liczba zwracanych firm
  pole opcjonalne
  wartość domyślna: 100
  wartość maksymalna: 1000
- location_coordinate
  Typ: string | null
  
  współrzędne GPS lokalizacji
  pole opcjonalne
  parametr location_coordinate należy podać w formacie "latitude,longitude,radius"
  maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
  wartość "radius" podaje się w kilometrach (km)
  minimalna wartość "radius": 1
  maksymalna wartość "radius": 100000
  przykład:
  53.476225,-2.243572,200
  więcej o ustawianiu parametrów lokalizacji w tym API znajdziesz w naszym Centrum pomocy
- offset
  Typ: integer | null
  
  przesunięcie w tablicy wyników zwracanych firm
  pole opcjonalne
  wartość domyślna: 0
  jeśli podasz wartość 10, pierwsze dziesięć encji w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych encji
  Uwaga: zalecamy używanie tego parametru tylko przy pobieraniu do 10 000 wyników
  do pobierania ponad 10 000 wyników użyj offset_token
- offset_token
  Typ: string | null
  
  token do kolejnych żądań
  pole opcjonalne
  podawany w tym samym polu odpowiedzi na każde żądanie;
  użyj tego parametru, aby uniknąć przekroczeń limitu czasu przy próbie pobrania ponad 100 000 wyników w jednym żądaniu;
  podając unikalną wartość offset_token z tablicy odpowiedzi, otrzymasz kolejne wyniki początkowego zadania;
  wartości offset_token są unikalne dla każdego kolejnego zadania
  Uwaga: jeśli w żądaniu podano offset_token, wszystkie pozostałe parametry muszą być identyczne jak w poprzednim żądaniu
  więcej o tym parametrze przeczytasz w naszym Centrum pomocy
- order_by
  Typ: array string[] | null
  
  zasady sortowania wyników
  pole opcjonalne
  do sortowania wyników możesz użyć tych samych wartości co w tablicy filters
  możliwe typy sortowania:
  asc — wyniki zostaną posortowane rosnąco
  desc — wyniki zostaną posortowane malejąco
  parametr sortowania ustawia się przecinkiem
  przykład:
  ["rating.value,desc"]pamiętaj, że w jednym żądaniu można ustawić nie więcej niż trzy zasady sortowania
  kilka zasad sortowania należy oddzielić przecinkiem
  przykład:
  ["rating.value,desc","rating.votes_count,desc"]
- 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
- title
  Typ: string | null
  
  tytuł elementu w SERP
  pole opcjonalne
  nazwa podmiotu gospodarczego, dla którego zbierane są wyniki;
  może zawierać do 200 znaków

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo
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_BusinessDataBusinessListingsSearchLiveTaskInfo
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

count
Typ: integer | null Format: int64

typy elementów
liczba elementów w tablicy items

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

napotkane typy elementów
typy wyników wyszukiwania napotkane w tablicy items;
możliwe typy elementów: business_listing

additional_categories
Typ: array (string | null)[] | null

dodatkowe kategorie działalności
dodatkowe kategorie Google My Business, które bardziej szczegółowo opisują usługi świadczone przez podmiot gospodarczy

address
Typ: string | null

adres podmiotu gospodarczego

address_info
Typ: object | null · Response36Afe1097B20_AddressInfo

obiekt zawierający składniki adresu podmiotu gospodarczego

address
Typ: string | null

adres ulicy lokalnego obiektu

borough
Typ: string | null

jednostka administracyjna lub dzielnica, do której należy lokalny obiekt

city
Typ: string | null

nazwa miasta, w którym znajduje się lokalny obiekt

country_code
Typ: string | null

kod kraju ISO lokalnego obiektu

region
Typ: string | null

region DMA, do którego należy lokalny obiekt

zip
Typ: string | null

kod pocztowy lokalnego obiektu

attributes
Typ: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

szczegóły usług w formie kontroli ocenianych przez użytkowników;
szczegóły usług podmiotu gospodarczego wyświetlane w formie kontroli i oparte na opiniach użytkowników oraz category firmy

available_attributes
Typ: object | null

dostępne atrybuty
wskazuje atrybuty, które może oferować podmiot gospodarczy

propertyName
Typ: array (string | null)[] | null
unavailable_attributes
Typ: object | null

niedostępne atrybuty
wskazuje atrybuty, których podmiot gospodarczy nie może oferować

propertyName
Typ: array (string | null)[] | null
category
Typ: string | null

kategoria działalności
ogólna kategoria Google My Business, która najlepiej opisuje usługi świadczone przez podmiot gospodarczy

category_ids
Typ: array (string | null)[] | null

globalne identyfikatory kategorii
uniwersalne identyfikatory kategorii, które nie zmieniają się w zależności od wybranego kraju

check_url
Typ: string | null

bezpośredni adres URL do wyników wyszukiwarki
możesz go użyć, aby upewnić się, że dostarczyliśmy dokładne wyniki

cid
Typ: string | null

identyfikator klienta definiowany przez Google
unikalny identyfikator lokalu
więcej o tym identyfikatorze znajdziesz w tym artykule Centrum pomocy

contact_info
Typ: array (object | null)[] | null

dostępne kontakty firmy
lista kontaktów do interakcji z firmą

source
Typ: string | null

źródło danych

type
Typ: string | null

typ elementu

value
Typ: string | null

wartość oceny

description
Typ: string | null

opis elementu w SERP
opis podmiotu gospodarczego, dla którego zbierane są wyniki

domain
Typ: string | null

domena podmiotu gospodarczego

feature_id
Typ: string | null

unikalny identyfikator elementu w SERP
więcej o identyfikatorze w tym artykule Centrum pomocy

first_seen
Typ: string | null

data i godzina, kiedy nasz crawler po raz pierwszy znalazł element wizytówki firmy
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2023-03-11 10:04:11 +00:00

hotel_rating
Typ: integer | null

klasa hotelu
klasy mieszczą się w zakresie od 1 do 5 gwiazdek, dowiedz się więcej
jeśli brak informacji o klasie hotelu, wartością będzie null

is_claimed
Typ: boolean | null

wskazuje, czy podmiot został zweryfikowany przez właściciela w Google Maps

last_updated_time
Typ: string | null

data i godzina ostatniej aktualizacji danych
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2023-01-26 09:03:15 +00:00

latitude
Typ: number | null

współrzędna szerokości geograficznej lokali w Mapach Google
przykład:
"latitude": 51.584091

local_business_links
Typ: array (object | null)[] | null

dostępne interakcje z firmą
lista opcji interakcji z firmą bezpośrednio z wyników wyszukiwania

type
Typ: string | null

typ elementu

logo
Typ: string | null

adres URL logo wyświetlanego w profilu Google My Business

longitude
Typ: number | null

współrzędna długości geograficznej lokalu w Mapach Google
przykład:
"longitude": -0.31365919999999997

main_image
Typ: string | null

adres URL głównego obrazu w profilu Google My Business

original_title
Typ: string | null

oryginalny tytuł elementu
oryginalny tytuł nieprzetłumaczony przez Google

people_also_search
Typ: array (object | null)[] | null

powiązane podmioty gospodarcze

cid
Typ: string | null

identyfikator klienta definiowany przez Google
unikalny identyfikator lokalu
więcej o tym identyfikatorze znajdziesz w tym artykule Centrum pomocy

feature_id
Typ: string | null

unikalny identyfikator elementu w SERP
więcej o identyfikatorze w tym artykule Centrum pomocy

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

ocena elementu
wskaźnik popularności oparty na opiniach, wyświetlany w SERP

rating_max
Typ: integer | null

maksymalna wartość dla rating_type

rating_type
Typ: string | null

typ oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

value
Typ: number | null Format: double

wartość oceny

votes_count
Typ: integer | null Format: int64

liczba opinii

title
Typ: string | null

tytuł elementu w SERP
nazwa podmiotu gospodarczego, dla którego zbierane są wyniki

phone
Typ: string | null

numer telefonu podmiotu gospodarczego

place_id
Typ: string | null

unikalny identyfikator miejsca
place id lokalu przedstawionego w elemencie
więcej o identyfikatorze przeczytasz w tym artykule centrum pomocy

place_topics
Typ: object | null

słowa kluczowe wymieniane w opiniach klientów
zawiera najpopularniejsze słowa kluczowe związane z produktami/usługami wymienianymi w opiniach klientów podmiotu gospodarczego oraz liczbę opinii, w których występuje każde słowo kluczowe
przykład:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

popular_times
Typ: object | null · Response36Afe1097B20_PopularTimes

godziny największego ruchu
informacje o godzinach wzmożonego ruchu w podmiocie gospodarczym

popular_times_by_days
Typ: object | null

popularne godziny
informacje o godzinach wzmożonego ruchu w lokalu w każdym dniu tygodnia

propertyName
Typ: array (object | null)[] | null

godziny pracy w niedziele

popular_index
Typ: integer | null

wskaźnik popularności względny wskaźnik popularności w czasie, mierzony od 0 do 100; wyższa wartość odpowiada większemu ruchowi o danej porze dnia

time
Typ: object | null · Response36Afe1097B20_TimeInfo

godziny w formacie 24-godzinnym

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

price_level
Typ: string | null

poziom cen lokalu
może przyjmować wartości: inexpensive, moderate, expensive, very_expensive
jeśli brak informacji o poziomie cen, wartością będzie null

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

ocena elementu
wskaźnik popularności oparty na opiniach, wyświetlany w SERP

rating_max
Typ: number | null Format: double

maksymalna wartość dla rating_type

rating_type
Typ: string | null

typ oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

value
Typ: number | null Format: double

wartość oceny

votes_count
Typ: integer | null Format: int64

liczba opinii

rating_distribution
Typ: object | null

rozkład ocen podmiotu gospodarczego
obiekt pokazuje liczbę ocen od 1 do 5 gwiazdek wystawionych przez użytkowników

propertyName
Typ: integer | null Format: Int64
services
Typ: array (object | null)[] | null
category
Typ: string | null

kategoria działalności
ogólna kategoria Google My Business, która najlepiej opisuje usługi świadczone przez podmiot gospodarczy

price
Typ: object | null · Response36Afe1097B20_PriceInfo
currency
Typ: string | null

waluta podanej ceny kod ISO waluty zastosowanej do ceny

current
Typ: number | null Format: double

bieżąca cena wskazuje bieżącą cenę produktu lub usługi prezentowanej w wyniku

displayed_price
Typ: string | null

ciąg ceny w wyniku surowy ciąg ceny w postaci dostarczonej w wyniku

is_price_range
Typ: boolean | null

cena podana jako zakres wskazuje, czy cena jest podana w formie zakresu

max_value
Typ: number | null Format: double

maksymalna cena maksymalna cena produktu lub usługi wskazana w wyniku

regular
Typ: number | null Format: double

cena regularna wskazuje cenę regularną produktu lub usługi bez zastosowanych rabatów

snippet
Typ: string | null

dodatkowe informacje o podmiocie gospodarczym

title
Typ: string | null

tytuł elementu w SERP
nazwa podmiotu gospodarczego, dla którego zbierane są wyniki

snippet
Typ: string | null

dodatkowe informacje o podmiocie gospodarczym

title
Typ: string | null

tytuł elementu w SERP
nazwa podmiotu gospodarczego, dla którego zbierane są wyniki

total_photos
Typ: integer | null Format: int64

łączna liczba obrazów w profilu Google My Business

type
Typ: string | null

typ elementu

url
Typ: string | null

bezwzględny URL podmiotu gospodarczego

work_time
Typ: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

szczegóły godzin pracy
informacje o godzinach działania podmiotu gospodarczego

work_hours
Typ: object | null · Response36Afe1097B20_WorkHours

godziny otwarcia
informacje o godzinach pracy lokalu

current_status
Typ: string | null

bieżący status obiektu
wskazuje, czy obiekt jest otwarty, czy zamknięty

timetable
Typ: object | null

harmonogram godzin pracy

propertyName
Typ: array (object | null)[] | null

godziny pracy w niedziele

close
Typ: object | null · Response36Afe1097B20_TimeInfo

godzina zamknięcia

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

open
Typ: object | null · Response36Afe1097B20_TimeInfo

godzina otwarcia

hour
Typ: integer | null

godziny w formacie 24-godzinnym

minute
Typ: integer | null

minuty

offset
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

offset_token
Typ: string | null
total_count
Typ: integer | null Format: int64

łączna liczba wyników w naszej bazie danych odpowiadających Twojemu żądaniu

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/business_data/business_listings/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/business_listings/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "categories": [
      "pizza_restaurant"
    ],
    "description": "pizza",
    "title": "pizza",
    "is_claimed": true,
    "location_coordinate": "53.476225,-2.243572,10",
    "order_by": [
      "rating.value,desc"
    ],
    "filters": [
      [
        "rating.value",
        ">",
        3
      ]
    ],
    "limit": 3
  }
]'

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": [
        {
          "total_count": null,
          "count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "type": null,
              "title": null,
              "original_title": null,
              "description": null,
              "category": null,
              "category_ids": [
                "[Max Depth Exceeded]"
              ],
              "additional_categories": [
                "[Max Depth Exceeded]"
              ],
              "cid": null,
              "feature_id": null,
              "address": null,
              "address_info": "[Max Depth Exceeded]",
              "place_id": null,
              "phone": null,
              "url": null,
              "domain": null,
              "logo": null,
              "main_image": null,
              "total_photos": null,
              "snippet": null,
              "latitude": null,
              "longitude": null,
              "is_claimed": null,
              "attributes": "[Max Depth Exceeded]",
              "place_topics": null,
              "rating": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "rating_type": "[Max Depth Exceeded]",
                "value": "[Max Depth Exceeded]",
                "votes_count": "[Max Depth Exceeded]",
                "rating_max": "[Max Depth Exceeded]"
              },
              "hotel_rating": null,
              "price_level": null,
              "rating_distribution": null,
              "people_also_search": [
                "[Max Depth Exceeded]"
              ],
              "work_time": "[Max Depth Exceeded]",
              "popular_times": "[Max Depth Exceeded]",
              "local_business_links": [
                "[Max Depth Exceeded]"
              ],
              "contact_info": [
                "[Max Depth Exceeded]"
              ],
              "check_url": null,
              "last_updated_time": null,
              "first_seen": null,
              "services": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Zadania wyszukiwania lokalnych wizytówek firm na żywo

UwierzytelnianieRequired

DataForSEO

Zadania wyszukiwania lokalnych wizytówek firm na żywo

Informacje o cenach