Ein Aufruf fragt ChatGPT, Gemini, Google, Copilot und in Korea Naver nach Ihrem Geschäft und liefert den Eintrag jeder Engine, die Kartendatenbank dahinter und jede Angabe, die von Ihren abweicht.
Was Sie erhalten
POST /v1/place-lookup nimmt ein Geschäft mit Namen und Adresse oder Kartenpunkt entgegen, dazu Telefon, Website und Place-IDs, wenn Sie sie haben, und fragt CHATGPT, GEMINI, GOOGLE, BING_COPILOT und bei Geschäften in KR auch NAVER_AI_TAB danach.
GET /v1/place-lookup/{id} liefert pro Engine den record des Geschäfts: seine source wie google_maps, naver_place oder yelp, seine placeId und Seite sowie Name, Adresse, Telefon, Website und Bewertung, die die Engine zeigt.
issues nennt, was an einem Eintrag falsch ist: phone_mismatch, website_mismatch, location_mismatch, other_business_record oder einen als geschlossen markierten Eintrag.
summary listet die Engines, die das Geschäft gezeigt haben, und die differences zwischen ihren Einträgen, und credits zeigt, was die Abfrage bisher abgerechnet hat.
So funktioniert es
Jede Engine erhält zwei Fragen, etwa Show Canlis on a map und dieselbe mit Adresse, und jede läuft als gewöhnliche Aufgabe dieser Engine. Bei Geschäften in KR sind die Fragen auf Koreanisch und die zweite Frage an ChatGPT auf Englisch. Unter den Orten der Antworten gilt der als Eintrag des Geschäfts, der per Place-ID, Telefon, Website, Kartenpunkt, Adresse und Name am besten passt, und match listet die übereinstimmenden Angaben. Die Abfrage wird bei jedem Lesen aus den gespeicherten Antworten neu bewertet, und die meisten Abfragen sind in zwei Minuten fertig.
Einsatzbereiche
Den Eintrag finden, aus dem eine falsche Telefonnummer stammt. Ein Fehler in einem Google-Maps-Eintrag erscheint in jeder Engine, die diesen Eintrag liest, und die Abfrage benennt ihn.
Erfahren, welche Kartendatenbank jede Engine in Ihrem Markt liest. In einem Test mit 20 Geschäften in den USA zeigte ChatGPT für 15 einen Yelp-Eintrag.
Vor einer lokalen Kampagne jede Filiale einer Kette prüfen, mit einer Abfrage pro Filiale.
Anfrage senden
Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.
Der Name des Geschäfts, 1 bis 200 Zeichen. Bei einer Kette mit der Filiale.
place.addressstring
Die Adresse, bis zu 500 Zeichen. Eine Abfrage braucht sie, place.location oder beides.
place.locationobject
Die Position des Geschäfts mit latitude und longitude. Dann trägt jeder Eintrag seine Entfernung zum Geschäft, und eine Markierung mehr als 300 m daneben wird gemeldet.
place.phonestring
Die offizielle Telefonnummer in beliebigem Format. Die Nummer jedes Eintrags wird damit verglichen.
place.websitestring
Die offizielle Website, eine http- oder https-URL. Die Website jedes Eintrags wird damit nach Website verglichen.
place.googlePlaceIdstring
Die Google Place ID des Geschäfts. Ein Eintrag mit dieser ID ist das Geschäft.
place.naverPlaceIdstring
Die Naver Place ID des Geschäfts oder seine Seite auf map.naver.com oder place.naver.com. Ein Eintrag mit dieser ID ist das Geschäft.
place.yelpUrlstring
Die Seite yelp.com/biz/… des Geschäfts. Ein Eintrag dieser Yelp-Seite ist das Geschäft.
countrystringPflicht
Das Land des Geschäfts als ISO-3166-1-Alpha-2-Code, etwa US oder KR.
enginesarray
Die abzufragenden Engines ohne Wiederholung: CHATGPT, GEMINI, GOOGLE, BING_COPILOT und für KRNAVER_AI_TAB. Standard: alle fünf für KR, die ersten vier anderswo.
idempotencyKeystring
Die ID der Abfrage, 1 bis 200 Zeichen. Standard: eine UUID vom Server. Dieselbe Anfrage damit erneut gesendet ergänzt die fehlenden Fragen.
Die ID der Abfrage. Lesen Sie das Ergebnis mit GET /v1/place-lookup/{id}.
tasksarray
Ein Eintrag pro Frage: engine, ask, success und die eingereihte task, status: "PENDING", solange sie auf Platz wartet, oder error mit Code. Der idempotencyKey der Aufgabe verbindet die ID der Abfrage, die Engine und die Fragenummer, etwa canlis-2026-10:CHATGPT:1.
Ergebnis abholen
Lesen Sie die Abfrage alle 5 bis 10 Sekunden über ihre ID, bis lookup.status den Wert COMPLETED hat. Sie bleibt 24 Stunden nach Ende ihrer Fragen abrufbar.
Die Abfrage zu Canlis sieht gekürzt so aus. ChatGPT zeigte den Yelp-Eintrag des Restaurants, Gemini und Copilot denselben Google-Maps-Eintrag, und die Google-Ergebnisseite antwortete ohne Ort, daher ist found gleich false.
PROCESSING, bis alle Engines fertig sind, danach COMPLETED.
lookup.engines[].foundboolean
true, sobald eine Antwort das Geschäft zeigt, false, wenn beide Fragen ohne es endeten, und null, solange eine Frage läuft oder wenn beide fehlschlugen.
lookup.engines[].recordobject
Der Eintrag des Geschäfts in dieser Engine: von den Orten beider Antworten der, der am besten passt, mit Name, Adresse, Telefon, Website und Bewertung, die die Engine zeigt.
lookup.engines[].record.sourcestring
Die Kartendatenbank hinter dem Eintrag: google_maps, naver_place, yelp, tripadvisor oder unknown. placeId und url sind dort seine ID und Seite.
lookup.engines[].record.matchobject
Warum der Eintrag das Geschäft ist. by listet die übereinstimmenden Angaben, nameScore ist die Namensähnlichkeit von 0 bis 1 und distanceMeters die Entfernung zu place.location.
lookup.engines[].issuesarray
Was am Eintrag falsch ist, wenn etwas falsch ist: phone_mismatch, website_mismatch, location_mismatch, other_business_record, closed_permanently oder closed_temporarily.
lookup.summaryobject
Die Engines nach Ergebnis in foundIn, notFoundIn, failed und pending sowie differences: jeder Name, jede Nummer, Website oder Markierung, die zwischen Engines abweicht, mit den Engines hinter jedem Wert.
lookup.creditsnumber
Die bisher für die Fragen der Abfrage berechneten Credits.
Fehler
Werden alle Fragen abgelehnt, ist die erste Ablehnung die Antwort, etwa 402 oder 403. Werden einige angenommen, antwortet der Aufruf mit 200, und jede abgelehnte Frage trägt ihren error. Solange die parallelen Aufgaben Ihres Plans belegt sind, warten die übrigen Fragen als PENDING und starten von selbst, sobald laufende Aufgaben fertig sind. So führt auch im kostenlosen Plan, der 2 Aufgaben gleichzeitig ausführt, eine einzige Anfrage die ganze Abfrage aus.
VALIDATION_ERRORHTTP 400
Ein Feld fehlt oder liegt außerhalb des erlaubten Bereichs. details nennt das Feld.
INSUFFICIENT_CREDITSHTTP 402
Das Guthaben liegt unter dem Preis der Aufgabe. Laden Sie Credits auf oder wechseln Sie den Plan und senden Sie erneut.
KEY_SCOPE_DENIEDHTTP 403
Die Engine liegt außerhalb der Erlaubten Engines des Schlüssels. Nutzen Sie einen anderen Schlüssel oder ergänzen Sie die Engine unter Schlüssel verwalten.
RESOURCE_ALREADY_EXISTSHTTP 409
Der idempotencyKey gehört bereits zu einer Abfrage mit anderem Geschäft, Land oder anderer Engine-Liste. Ein neuer idempotencyKey startet eine neue Abfrage.
Preis
Eine Abfrage der Standard-Engines des Landes kostet 10 Credits: 1 pro Frage für die 10 Fragen in KR und 1,25 für jede der 8 Fragen anderswo. Eine Abfrage mit weniger Engines zahlt die Fragen, die sie sendet, und eine fehlgeschlagene Frage kostet 0. Die Planpreise stehen unter https://querying.ai/pricing .
Übergeben Sie die URL einer Produktseite von Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando oder 11 weiteren Shops und erhalten Sie Preis, Bestand, Galerie- und Beschreibungsbilder, technische Daten und Optionen im selben Format.
Durchsuchen Sie Amazon, Walmart, Coupang, Olive Young, Rakuten, Flipkart, Zalando und 13 weitere Shops in fünf Ländern und erhalten Sie das Produktranking jedes Shops mit Preisen, Bewertungen und Rezensionszahlen im selben Format.