Naver Blog Search

curl --request GET \
  --url https://socialquery.dev/v1/naver/blog/search \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/naver/blog/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "post": {
          "id": "<string>",
          "url": "<string>",
          "content": {
            "text": "<string>",
            "media_urls": [
              "<string>"
            ],
            "thumbnail_url": "<string>",
            "duration_seconds": null
          },
          "author": {
            "username": "<string>",
            "display_name": "<string>",
            "url": "<string>",
            "avatar_url": null,
            "verified": null
          },
          "engagement": {
            "views": null,
            "likes": null,
            "comments": null,
            "shares": null
          },
          "published_at": null,
          "ext": {
            "title": "<string>",
            "published_date": "<string>",
            "published_label": "<string>",
            "published_at_precision": "day"
          }
        },
        "title": "<string>",
        "link": "<string>",
        "description": "<string>",
        "bloggername": "<string>",
        "bloggerlink": "<string>",
        "postdate": "<string>"
      }
    ],
    "returned_count": 1,
    "total": null,
    "display": 50,
    "start": 500,
    "source_rows_scanned": 1,
    "dropped": 1,
    "date_filtered": 1,
    "source_pages": [
      17
    ],
    "has_more": true,
    "next_cursor": "<string>",
    "source": "scrapebadger",
    "coverage_note": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

GET

naver

blog

Naver Blog Search

curl --request GET \
  --url https://socialquery.dev/v1/naver/blog/search \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://socialquery.dev/v1/naver/blog/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "data": {
    "items": [
      {
        "post": {
          "id": "<string>",
          "url": "<string>",
          "content": {
            "text": "<string>",
            "media_urls": [
              "<string>"
            ],
            "thumbnail_url": "<string>",
            "duration_seconds": null
          },
          "author": {
            "username": "<string>",
            "display_name": "<string>",
            "url": "<string>",
            "avatar_url": null,
            "verified": null
          },
          "engagement": {
            "views": null,
            "likes": null,
            "comments": null,
            "shares": null
          },
          "published_at": null,
          "ext": {
            "title": "<string>",
            "published_date": "<string>",
            "published_label": "<string>",
            "published_at_precision": "day"
          }
        },
        "title": "<string>",
        "link": "<string>",
        "description": "<string>",
        "bloggername": "<string>",
        "bloggerlink": "<string>",
        "postdate": "<string>"
      }
    ],
    "returned_count": 1,
    "total": null,
    "display": 50,
    "start": 500,
    "source_rows_scanned": 1,
    "dropped": 1,
    "date_filtered": 1,
    "source_pages": [
      17
    ],
    "has_more": true,
    "next_cursor": "<string>",
    "source": "scrapebadger",
    "coverage_note": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Searches the native Naver Blog relevance index using the already configured ScrapeBadger account. Naver Cloud credentials are not required for this operation. The official Naver paid-account setup remains on hold. Each row contains a canonical post plus compatibility fields title, link, description, bloggername, bloggerlink and postdate. Korean text is preserved; highlight tags are stripped and entities decoded. The provider supplies calendar days or relative labels, so post.published_at remains null. Exact calendar days appear in post.ext.published_date with published_at_precision: "day"; relative/unknown dates remain null. Views, likes, comments and author verification are unknown, not zero. Use display or limit (1–100; default 10), with start (1–1000), or return next_cursor alone. Matching aliases must agree. A cursor binds the query, requested size and inclusive since/until calendar-day filters for one hour. Conflicting explicit values are rejected. Date filtering excludes rows without a known date, and pagination advances over scanned source rows even when every row is filtered out. Each source page contains up to 30 rows; a requested window uses at most five bounded parallel source reads. Within a response, duplicate post IDs are removed and counted in dropped. Rankings can change across requests: the two live source pages overlapped on 13 of 30 IDs. Deduplicate by post.id across pages. The source does not supply a reliable total, so total is null. Full source pages may lead to an empty terminal page. Traversal stops at source position 1,000; cursors are not snapshots or an exhaustive collection guarantee. Known production limitation: both audited 100-row requests failed because the provider repeated an entire later page. These requests were rejected with HTTP 502 and refunded. Smaller windows and first/second-page continuation passed. Large-window and deeper-pagination reliability are not certified; do not assume that the accepted 100-row/1,000-offset bounds establish working coverage. Only sort=sim and judgments=off are supported. Date sorting, AI relevance/fit/labeling, dry runs and synthesis are rejected with an unbilled 422. These remain feature-parity gaps. A fresh nonempty result costs 1 credit. Errors, empty/fully filtered windows, cache hits and successful idempotent replays cost zero. Use X-Max-Credits: 1. All source reads are reserved against the shared 500-credit ScrapeBadger verification ceiling before any request starts; up to five pages use up to 25 provider credits. Missing/exhausted budget state fails closed. Requests have a 45-second shared timeout and a 2 MiB per-page bound. This approved verification allowance is not a permanent production capacity commitment; no purchase or top-up is enabled.

Authorizations

x-api-key

string

header

required

Headers

Cache-Control

string

Idempotency-Key

string

X-Max-Credits

integer

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.

Required range: x >= 0

Query Parameters

query

string

Korean or other search text, up to 500 characters; alternatively supply a returned cursor.

display

integer

Requested source rows, 1–100 (default 10). Both aliases must agree. Duplicate/date filtering can reduce returned_count.

Required range: 1 <= x <= 100

start

integer

One-based source offset, 1–1000. Cursors preserve remaining source positions.

Required range: 1 <= x <= 1000

sort

enum<string>

Only sim (native relevance order) is supported by this provider; date is rejected.

Available options:

sim

relevance

enum<string>

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

Available options:

score,

filter

relevance_threshold

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

relevant_to

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

judgments

enum<string>

Only off is supported; no AI synthesis or scoring is performed.

Available options:

off

dry_run

enum<string>

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

Available options:

1

fit

enum<string>

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

Available options:

goal

goal

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

fit_tokens

integer

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

label

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

exclude

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

brand

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

brand_description

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

offer

string

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

label_evidence

enum<string>

Unsupported by the current native-blog adapter; supplying this parameter returns an unbilled 422.

Available options:

1

since

string<date>

Inclusive YYYY-MM-DD calendar-day filter within the scanned window. Rows with unknown dates are excluded when either bound is supplied.

until

string<date>

Inclusive YYYY-MM-DD calendar-day filter within the scanned window. Rows with unknown dates are excluded when either bound is supplied.

cursor

string

Opaque one-hour next_cursor; can be used alone. Binds query, requested size and date filters; explicit conflicts are rejected.

limit

integer

Requested source rows, 1–100 (default 10). Both aliases must agree. Duplicate/date filtering can reduce returned_count.

Required range: 1 <= x <= 100

Response

Native Naver Blog relevance results through the existing ScrapeBadger provider. Up to 100 source rows from at most five source pages, start 1–1000, with query-bound cursor continuation. Preserves Korean, source calendar days and unknown dates; does not invent exact publish timestamps. Date sorting and AI enrichment are unsupported. Empty or fully filtered windows are free.

success

boolean

required

platform

string

required

endpoint

string

required

credits_used

integer

required

Required range: x >= 0

credits_remaining

integer | null

required

request_id

string

required

cached

boolean

required

data

object

required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.

Show child attributes