> ## Documentation Index > Fetch the complete documentation index at: https://socialquery.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Naver Local Search > Verification limitation: repeated live source checks returned an empty result window after an earlier successful fixture. Nonempty production readiness is unresolved. Search the first public Naver local-result window through ScrapeBadger. Returns up to five organic places after excluding marked advertisements, so the result may contain fewer than requested. Addresses, phones, exact totals and other unavailable fields remain null. Source relevance order is used; native random/comment ranking parity is not claimed. No continuation. Initial provider verification is capped at 200 shared provider credits; the route returns an uncharged availability error once exhausted. Search the first public Naver local-result window through ScrapeBadger. Returns up to five organic places after excluding marked advertisements, so the result may contain fewer than requested. Addresses, phones, exact totals and other unavailable fields remain null. Source relevance order is used; native random/comment ranking parity is not claimed. No continuation. One uncached successful request costs **1 SocialQuery credit**. Cache hits and failed requests cost zero. Initial upstream verification has a shared 200-credit provider cap; exhausted or unavailable budget storage prevents a new provider request. This does not activate NAVER Cloud billing or provide native API coverage. Repeated production and direct-source checks returned an empty source window after an earlier successful fixture. Nonempty production readiness is unresolved; this route is not certified as reliable coverage. ## OpenAPI ````yaml GET /naver/local/search openapi: 3.1.0 info: title: SocialQuery API version: '2026-10-09' description: >- Documented requests for public-source records. Inspect accepted inputs and credit amounts, then verify the selected operation before integrating preview coverage. servers: - url: https://socialquery.dev/v1 security: - apiKey: [] paths: /naver/local/search: get: tags: - Naver summary: Naver Local Search description: >- Verification limitation: repeated live source checks returned an empty result window after an earlier successful fixture. Nonempty production readiness is unresolved. Search the first public Naver local-result window through ScrapeBadger. Returns up to five organic places after excluding marked advertisements, so the result may contain fewer than requested. Addresses, phones, exact totals and other unavailable fields remain null. Source relevance order is used; native random/comment ranking parity is not claimed. No continuation. Initial provider verification is capped at 200 shared provider credits; the route returns an uncharged availability error once exhausted. operationId: get_naver_local_search parameters: - name: query in: query required: true example: 강남 파스타 schema: type: string - name: display in: query required: false example: 5 schema: type: integer minimum: 1 maximum: 5 description: Maximum rows from one source page. Fewer rows may be returned. - name: sort in: query required: false schema: type: string enum: - random - comment description: >- Only the default value is supported (sim for Cafe/Knowledge iN, random for local). This selects source relevance order, not native API ranking parity. - name: Cache-Control in: header required: false example: no-cache schema: type: string - name: Idempotency-Key in: header required: false example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c schema: type: string - name: X-Max-Credits in: header required: false description: >- Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero. schema: type: integer minimum: 0 responses: '200': description: >- Search the first public Naver local-result window through ScrapeBadger. Returns up to five organic places after excluding marked advertisements, so the result may contain fewer than requested. Addresses, phones, exact totals and other unavailable fields remain null. Source relevance order is used; native random/comment ranking parity is not claimed. No continuation. content: application/json: schema: allOf: - $ref: '#/components/schemas/SocialQueryResponse' - type: object properties: data: type: object properties: items: type: array items: type: object properties: id: type: - string - 'null' title: type: - string - 'null' link: type: - string - 'null' description: type: - string - 'null' category: type: - string - 'null' address: type: - string - 'null' road_address: type: - string - 'null' phone: type: - string - 'null' published_date: type: - string - 'null' date_precision: type: - string - 'null' author: type: - string - 'null' community_name: type: - string - 'null' question: type: - string - 'null' answer_snippet: type: - string - 'null' published_at: type: 'null' rating: type: - number - 'null' review_count: type: - integer - 'null' comment_count: type: - integer - 'null' is_open: type: - boolean - 'null' is_ad: type: - boolean - 'null' returned_count: type: integer minimum: 0 source_window_count: type: integer minimum: 0 total: type: 'null' next_cursor: type: - string - 'null' source: type: string const: scrapebadger excluded_ads: type: integer minimum: 0 coverage_note: type: string '400': $ref: '#/components/responses/Error400' '401': $ref: '#/components/responses/Error401' '402': $ref: '#/components/responses/Error402' '403': $ref: '#/components/responses/Error403' '404': $ref: '#/components/responses/Error404' '405': $ref: '#/components/responses/Error405' '409': $ref: '#/components/responses/Error409' '422': $ref: '#/components/responses/Error422' '429': $ref: '#/components/responses/Error429' '500': $ref: '#/components/responses/Error500' '502': $ref: '#/components/responses/Error502' '503': $ref: '#/components/responses/Error503' '504': $ref: '#/components/responses/Error504' components: schemas: SocialQueryResponse: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - data properties: success: type: boolean const: true platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean data: type: object additionalProperties: true description: >- The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null. SocialQueryError: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - error properties: success: type: boolean const: false platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean error: type: object required: - code - type - message - status - doc_url properties: code: type: string type: type: string message: type: string status: type: integer doc_url: type: string format: uri responses: Error400: description: Upstream rejected the request. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error401: description: Missing, expired, invalid, or revoked API key. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error402: description: Insufficient SocialQuery credits. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error403: description: Key scope or provider policy denied access. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error404: description: Endpoint or upstream resource not found. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error405: description: HTTP method is not supported. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error409: description: Idempotency conflict or request in progress. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error422: description: Invalid parameters. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error429: description: Request limit reached. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error500: description: Request processing failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error502: description: Upstream service failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error503: description: Provider or required service is unavailable. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error504: description: Upstream service timed out. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.