> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a place lookup > Read each engine's record of the store: its source, its details and what differs from the store's own. ## OpenAPI ````yaml GET /v1/place-lookup/{id} openapi: 3.1.0 info: title: querying.ai description: >- One API for every AI answer engine. Every task is asynchronous: submit, then collect the result via webhook or polling. version: 1.0.0 servers: - url: https://api.querying.ai description: Production security: - bearerAuth: [] paths: /v1/place-lookup/{id}: get: tags: - Research summary: Get a place lookup description: >- Each engine's record of the store, judged from the stored answers on every read: whether the answers showed the store (found), the record's map database (source), what the record says, what is wrong with it (issues), and where the engines' records disagree (summary.differences). Readable for 24 hours after the lookup's tasks complete. operationId: getPlaceLookup parameters: - name: id in: path required: true description: 'The lookup id: your idempotencyKey, or the UUID the server minted.' schema: type: string responses: '200': description: The lookup, judged per engine. content: application/json: schema: $ref: '#/components/schemas/PlaceLookupResult' example: success: true lookup: id: canlis-2026-10 status: COMPLETED place: name: Canlis address: 2576 Aurora Ave N, Seattle, WA 98109 location: latitude: 47.6430534 longitude: -122.3467361 phone: (206) 283-3313 website: https://canlis.com/ country: US engines: - engine: CHATGPT status: COMPLETED found: true via: - taskType: CHATGPT prompt: Show Canlis on a map taskId: 9d02deef-4c1c-47db-8d86-e1a71f8b00e8 status: COMPLETED collectedAt: '2026-10-19T16:38:48.957Z' places: 1 - taskType: CHATGPT prompt: >- Show Canlis, 2576 Aurora Ave N, Seattle, WA 98109 on a map taskId: 91505c8f-d2d6-4bd3-8623-a8706249f1e1 status: COMPLETED collectedAt: '2026-10-19T16:39:04.194Z' places: 1 record: position: 1 name: Canlis source: yelp provider: yelp-feed url: >- https://www.yelp.com/biz/canlis-seattle?adjust_creative=openai address: 2576 Aurora Ave N, Seattle, WA 98109, United States latitude: 47.6430933 longitude: -122.3467535 phone: +1 206-283-3313 category: Pacific Northwest restaurant (US) rating: 4 reviewCount: 1935 website: https://canlis.com/ match: same: true by: - phone - website - location - address - name nameScore: 1 distanceMeters: 5 - engine: GEMINI status: COMPLETED found: true via: - taskType: GEMINI prompt: Show Canlis on a map taskId: f659899b-6dc8-487d-b33e-bdabd98ec562 status: COMPLETED collectedAt: '2026-10-19T16:38:48.831Z' places: 1 - taskType: GEMINI prompt: >- Show Canlis, 2576 Aurora Ave N, Seattle, WA 98109 on a map taskId: f93bc0cc-070b-4ccc-a113-07581795105e status: COMPLETED collectedAt: '2026-10-19T16:38:48.861Z' places: 1 record: position: 1 name: Canlis source: google_maps placeId: ChIJRXCfNwUVkFQRxraD8U-dANE url: https://maps.google.com/?cid=15060210120606856902 address: 2576 Aurora Ave N, Seattle, WA 98109 latitude: 47.6430933 longitude: -122.34675349999999 phone: +1 206-283-3313 category: American restaurant rating: 4.6 reviewCount: 2892 website: https://canlis.com/ match: same: true by: - phone - website - location - address - name nameScore: 1 distanceMeters: 5 - engine: GOOGLE status: COMPLETED found: false via: - taskType: GOOGLE query: Canlis location taskId: 6d3c3a73-8193-4b82-a17b-3d3441afef7d status: COMPLETED collectedAt: '2026-10-19T16:38:43.932Z' places: 0 - taskType: GOOGLE query: Canlis location: latitude: 47.6430534 longitude: -122.3467361 taskId: 980a858a-00d7-442c-b9be-b2ad75202b13 status: COMPLETED collectedAt: '2026-10-19T16:38:48.902Z' places: 0 - engine: BING_COPILOT status: COMPLETED found: true via: - taskType: BING_COPILOT prompt: Show Canlis on a map taskId: a9166a27-205b-4eb0-b8ec-248c0b5d149c status: COMPLETED collectedAt: '2026-10-19T16:38:53.967Z' places: 1 - taskType: BING_COPILOT prompt: >- Show Canlis, 2576 Aurora Ave N, Seattle, WA 98109 on a map taskId: 4f8afd8a-866d-4e17-8a29-acca4e53e056 status: COMPLETED collectedAt: '2026-10-19T16:38:53.983Z' places: 1 record: position: 1 name: Canlis source: google_maps placeId: ChIJRXCfNwUVkFQRxraD8U-dANE url: https://maps.google.com/?cid=15060210120606856902 address: 2576 Aurora Ave N, Seattle, WA 98109 latitude: 47.6430933 longitude: -122.34675349999999 phone: (206) 283-3313 category: >- Pacific Northwest restaurant (US),American restaurant,Bar,Fine dining restaurant,New American restaurant,Restaurant rating: 4.6 reviewCount: 2892 website: https://canlis.com/ openState: Closed ยท Opens 5 PM Tue match: same: true by: - phone - website - location - address - name nameScore: 1 distanceMeters: 5 summary: foundIn: - CHATGPT - GEMINI - BING_COPILOT notFoundIn: - GOOGLE failed: [] pending: [] differences: [] credits: 10 '400': description: >- Request rejected: the lookup id is missing or longer than 200 characters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': $ref: '#/components/responses/Unauthorized' '404': description: >- No lookup with this id for your account, or its tasks are past the 24-hour window. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: RESOURCE_NOT_FOUND message: Place lookup not found details: id: canlis-2026-10 timestamp: '2026-10-20T09:00:00.000Z' components: schemas: PlaceLookupResult: type: object properties: success: type: boolean lookup: type: object properties: id: type: string status: type: string enum: - PROCESSING - COMPLETED place: $ref: '#/components/schemas/PlaceLookupPlace' country: type: string engines: type: array items: $ref: '#/components/schemas/PlaceLookupEngineResult' summary: type: object properties: foundIn: type: array items: $ref: '#/components/schemas/PlaceLookupEngine' notFoundIn: type: array items: $ref: '#/components/schemas/PlaceLookupEngine' failed: type: array items: $ref: '#/components/schemas/PlaceLookupEngine' pending: type: array items: $ref: '#/components/schemas/PlaceLookupEngine' differences: type: array items: type: object properties: field: type: string enum: - name - phone - website - location values: type: array items: type: object properties: value: type: string engines: type: array items: $ref: '#/components/schemas/PlaceLookupEngine' spreadMeters: type: number description: 'location only: the largest distance between two pins.' credits: type: number description: Credits charged so far for the lookup's questions. ErrorResponse: type: object required: - success - error properties: success: type: boolean const: false error: $ref: '#/components/schemas/ErrorDetail' PlaceLookupPlace: type: object additionalProperties: false required: - name description: The store and its official details. address or location is required. properties: name: type: string minLength: 1 maxLength: 200 description: The store's name. For a chain, include the branch. address: type: string maxLength: 500 description: The street address. location: $ref: '#/components/schemas/LocationPoint' description: >- The store's pin. With it, each record carries distanceMeters and a pin more than 300 m away is reported as location_mismatch. phone: type: string maxLength: 50 description: The official phone number, in any format. website: type: string format: uri description: The official website, an http or https URL. googlePlaceId: type: string description: The store's Google Place ID. A record with this ID is the store. naverPlaceId: type: string description: >- The store's Naver Place ID, or its map.naver.com or place.naver.com page. yelpUrl: type: string format: uri description: The store's yelp.com/biz/ page. PlaceLookupEngineResult: type: object properties: engine: $ref: '#/components/schemas/PlaceLookupEngine' status: type: string enum: - PROCESSING - COMPLETED - FAILED description: COMPLETED once both questions ended, FAILED when both failed. found: type: - boolean - 'null' description: >- true once an answer shows the store; false when both questions ended without it; null while a question runs and when both failed. via: type: array items: $ref: '#/components/schemas/PlaceLookupAsk' record: $ref: '#/components/schemas/PlaceRecord' issues: type: array items: type: string enum: - other_business_record - phone_mismatch - website_mismatch - location_mismatch - closed_permanently - closed_temporarily description: What is wrong with the record. Present only when something is. PlaceLookupEngine: type: string enum: - CHATGPT - GEMINI - GOOGLE - BING_COPILOT - NAVER_AI_TAB description: An engine a place lookup asks. NAVER_AI_TAB answers for KR only. ErrorDetail: type: object required: - code - message properties: code: type: string description: Stable, safe to branch on. See the Errors guide for the full list. message: type: string description: For humans. May change. details: description: >- Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add. oneOf: - type: array items: type: object properties: field: type: string message: type: string - type: object additionalProperties: true timestamp: type: string format: date-time LocationPoint: type: object additionalProperties: false required: - latitude - longitude properties: latitude: type: number minimum: -90 maximum: 90 longitude: type: number minimum: -180 maximum: 180 example: latitude: 37.4979 longitude: 127.0276 PlaceLookupAsk: type: object description: One question as it was sent, and its task. properties: taskType: $ref: '#/components/schemas/PlaceLookupEngine' prompt: type: string query: type: string location: $ref: '#/components/schemas/LocationPoint' taskId: type: string format: uuid description: Present once the question has started. status: type: string enum: - PENDING - QUEUED - PROCESSING - COMPLETED - FAILED - TIMEOUT description: >- PENDING while the question waits for room in the plan or the engine's queue. collectedAt: type: string format: date-time places: type: integer description: How many places the answer showed. error: type: string description: A failed question's error, starting with its code. PlaceRecord: type: object description: >- One engine's record of the store. Only fields the answer carries are present. properties: position: type: integer description: Order among the places in the answer, from 1. name: type: string localName: type: string description: 'CHATGPT only: the record''s other name.' source: type: string enum: - google_maps - naver_place - yelp - tripadvisor - unknown description: The record's map database. provider: type: string description: >- CHATGPT only: the feed ChatGPT names for the record, such as yelp-feed. resolvedBy: type: string enum: - address description: >- CHATGPT only: ChatGPT found the record by an address the model wrote. placeId: type: string description: The record's ID at its source. url: type: string description: The record's page at its source. address: type: string latitude: type: number longitude: type: number phone: type: string category: type: string rating: type: number reviewCount: type: integer website: type: string openState: type: string description: The engine's open-now label at answer time. closed: type: string enum: - permanently - temporarily description: CHATGPT only. image: type: string description: type: string match: $ref: '#/components/schemas/PlaceMatch' PlaceMatch: type: object properties: same: type: boolean by: type: array items: type: string enum: - place_id - phone - website - location - address - name description: The details that agree with the store. nameScore: type: number minimum: 0 maximum: 1 description: Name similarity. distanceMeters: type: number description: From place.location to the record's pin. otherBusiness: type: boolean description: >- Present as true when the record's phone and website both differ from the store's. responses: Unauthorized: description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: MISSING_API_KEY message: Missing or invalid API key timestamp: '2026-07-09T04:12:00.000Z' securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.