> ## 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 Encyclopedia Search

> Anonymous Naver Knowledge Encyclopedia search excerpts and links, with native relevance/latest order and bounded continuation. No Naver Cloud key required. Includes Korean text, source categories and thumbnails without inventing dates or totals. Query corrections/adult gates fail closed.

Searches the anonymous [Naver Knowledge Encyclopedia](https://terms.naver.com/search?query=인공지능) index. This uses its public search UI and read-only continuation action; **no Naver Cloud credential is required**. The separate paid account setup remains on hold.

Results preserve native public IDs, titles, source links, plain-text excerpts, nullable thumbnails, categories, source names and content types. These are search excerpts, not full entry contents. The source mixes encyclopedia, video and magazine records. Global totals, publication timestamps and ranking scores are not supplied or invented; `total` is null.

Use `query`, `display` or `limit` (1–100; default 10), `start` (1–1000), and `sort=sim` (native relevance, default) or `sort=date` (native latest). Windows stop at source position 1,000. A returned `next_cursor` may be used alone and binds the query, size and sort for one hour. Explicit conflicts return an unbilled 422. The source rounds offsets to 30-row page boundaries; the adapter fetches aligned pages and slices the requested window, including short cursor pages and the final offset. Pagination advances over scanned positions, deduplicates within a window and rejects repeated full pages. Rankings are live and may shift; deduplicate by `id` across requests. Cursors are not snapshots or an exhaustive collection guarantee.

Each request verifies the public bootstrap query and exact continuation binding. It decodes data-only records, including length-prefixed UTF-8 excerpts, without executing scripts. Corrections, adult gates, changed source contracts and invalid provenance fail closed. Source links and thumbnails are returned without fetching entry bodies or downloading media. No account, cookie, user-profile, like or write API is called.

Fresh nonempty results cost **1 credit**. Empty results, errors, cache hits and successful idempotent replays cost zero. Use `X-Max-Credits: 1`. Each response is bounded to 2 MiB, the whole request to 45 seconds, and source reads to 20/minute. A request uses at most six anonymous reads (bootstrap plus five aligned native pages). There is no paid provider charge, vendor SLA or sustainable-capacity guarantee.


## OpenAPI

````yaml GET /naver/encyc/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/encyc/search:
    get:
      tags:
        - Naver
      summary: Naver Encyc Search
      description: >-
        Anonymous Naver Knowledge Encyclopedia search excerpts and links, with
        native relevance/latest order and bounded continuation. No Naver Cloud
        key required. Includes Korean text, source categories and thumbnails
        without inventing dates or totals. Query corrections/adult gates fail
        closed.
      operationId: get_naver_encyc_search
      parameters:
        - name: query
          in: query
          required: false
          example: 인공지능
          schema:
            type: string
          description: >-
            Search text up to 500 characters; alternatively return next_cursor
            alone.
        - name: display
          in: query
          required: false
          example: 10
          schema:
            type: integer
            minimum: 1
            maximum: 100
          description: >-
            Requested source rows, 1–100; default 10. Aliases must agree.
            Deduplication may reduce returned_count.
        - name: start
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000
          description: >-
            One-based native source position, 1–1000; windows stop at position
            1000.
        - name: sort
          in: query
          required: false
          schema:
            type: string
            enum:
              - sim
              - date
          description: Native relevance order (sim, default) or latest order (date).
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Opaque one-hour next_cursor; binds query, display and sort. Can be
            used alone; explicit conflicts are rejected.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
          description: >-
            Requested source rows, 1–100; default 10. Aliases must agree.
            Deduplication may reduce returned_count.
        - 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: >-
            Anonymous Naver Knowledge Encyclopedia search excerpts and links,
            with native relevance/latest order and bounded continuation. No
            Naver Cloud key required. Includes Korean text, source categories
            and thumbnails without inventing dates or totals. Query
            corrections/adult gates fail closed.
          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
                                title:
                                  type: string
                                link:
                                  type: string
                                description:
                                  type:
                                    - string
                                    - 'null'
                                thumbnail:
                                  type:
                                    - string
                                    - 'null'
                                category:
                                  type:
                                    - string
                                    - 'null'
                                source_name:
                                  type:
                                    - string
                                    - 'null'
                                content_type:
                                  type: string
                              required:
                                - id
                                - title
                                - link
                                - description
                                - thumbnail
                                - category
                                - source_name
                                - content_type
                          returned_count:
                            type: integer
                            minimum: 0
                          total:
                            type: 'null'
                          query:
                            type: string
                          display:
                            type: integer
                            minimum: 1
                            maximum: 100
                          start:
                            type: integer
                            minimum: 1
                            maximum: 1000
                          sort:
                            type: string
                            enum:
                              - sim
                              - date
                          source_rows_scanned:
                            type: integer
                            minimum: 0
                          dropped:
                            type: integer
                            minimum: 0
                          has_more:
                            type: boolean
                          next_cursor:
                            type:
                              - string
                              - 'null'
                          source:
                            type: string
                            const: naver_terms
                          coverage_note:
                            type: string
                        required:
                          - items
                          - returned_count
                          - total
                          - query
                          - display
                          - start
                          - sort
                          - source_rows_scanned
                          - dropped
                          - has_more
                          - next_cursor
                          - source
                          - coverage_note
        '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.