스레드 키워드 검색 관련도, 20건 중 15건이 남아요

2026년 9월 8일 00:14 UTC, SocialCrawl GET /v1/threads/search?query=cari ai automation은 게시물 20건을 돌려줬어요. 그중 15건(75%)은 입력 단어 cari, ai, automation 중 본문 통단어 2개 이상을 담았고, 1크레딧이 찍혔어요. 이게 이 글에서 말하는 스레드 키워드 검색 관련도예요.

한 호출에 몇 건까지 모이는지는 이미 스레드 검색 API, 한 호출에 55건에 정리해 두었어요. 이 글은 그 건수가 입력 단어에 머무르는지만 봐요. 아래 JSON은 지어낸 예시가 아니에요. 그날 받은 봉투를 항목 하나만 남기고 줄인 거예요. 재현할 때 키는 $SOCIALCRAWL_API_KEY를 넣으면 돼요.

Threads는 2026년 6월 기준 월간 활성 사용자 5억이에요. 그 규모에서 입력 단어에 안 남는 창은 리스닝이든 분류기든 노이즈 세금이 돼요. 공식 Threads API의 게시·OAuth·앱 심사는 스레드 API 글을 보세요.

스레드 키워드 검색, 입력 단어에 얼마나 머무르나요?

공식 키워드 검색은 입력 단어 점수를 안 줘요. search_type은 TOP(기본)과 RECENT뿐이에요. 스레드 키워드 검색은 그 위에, 입력 단어가 본문에 몇 개 남았는지를 봐요. 세는 법은 단순해요. 본문 post.content.text에서 쿼리 단어를 양쪽 경계 통단어로 세고, 2개 이상인 행을 페이지 건수로 나눈 값이에요. 토픽 태그와 인용문은 분자에 넣지 않아요.

2026-09-08 00:14 UTC에 친 첫 과금 창은 이 호출이었어요.

curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/threads/search?query=cari%20ai%20automation"

돌아온 봉투는 credits_used=1, cached=false, dropped=0, has_more=false, 커서 없음, 지연 5,604ms, request_id=req-B1nKGNBEA20fk0U2예요. len(data.items)는 20이에요. 항목을 하나만 남기면 이래요.

{
  "success": true,
  "platform": "threads",
  "endpoint": "/v1/threads/search",
  "credits_used": 1,
  "cached": false,
  "request_id": "req-B1nKGNBEA20fk0U2",
  "pagination": {
    "has_more": false,
    "page_size": 20
  },
  "data": {
    "_warnings": [
      "No Threads post matched \"cari ai automation\" as a phrase, so the query was expanded into 2 narrower searches (cari ai, ai automation) and 1 of them returned posts. Results are merged, de-duplicated and ordered by how many of your terms each post contains. You are billed 1 credit per search that returned posts, and an expanded response is a single page with no pagination cursor. Send expand=false to search the exact phrase only."
    ],
    "items": [
      {
        "post": {
          "id": "3966216076262486892",
          "url": "https://www.threads.com/@zvka.x/post/DcK1IHoEbNs",
          "author": { "username": "zvka.x" },
          "engagement": { "likes": 411, "comments": 801 },
          "published_at": "2026-08-18T05:10:22.000Z",
          "content": {
            "text": "This FREE AI + Automation course can take you from beginner → advanced. No fluff. Just a practical roadmap to learn AI, build workflows & automate real tasks."
          },
          "ext": { "topic_tag": null }
        }
      }
    ]
  }
}

첫 행 @zvka.x는 통합 스키마 게시물 객체예요. 본문 통단어는 ai와 automation 두 개고, cari는 없어요. 토픽 태그도 비어 있어요. 바로 다음 행 @sassysaaraa (https://www.threads.com/@sassysaaraa/post/DbnoCAckZnX)는 좋아요 369, 토픽 태그 AI automation, 본문 통단어도 ai와 automation이에요.

같은 20건을 통단어 개수로 나누면 이 표가 나와요.

단어별 본문 횟수는 cari=0, ai=17, automation=15예요. 세 단어가 한 본문에 같이 있는 행은 오늘 이 페이지에 없어요. cari는 인도네시아어로 「찾다」인데, 첫 페이지 본문에 한 번도 안 나왔어요. 완화된 다리는 ai automation 쪽이에요.

분모에는 토픽 태그로만 걸린 행도 들어가요. 랭킹은 단어가 적다고 행을 버리지 않아요. 그래서 0개 구간 3건이 페이지에 남아 있어요. 헤드라인 75%는 그 분모 위에서 센 값이에요.

같은 날 00:20 UTC, 검색 캐시 120초가 끝난 뒤 같은 쿼리를 다시 치면 또 20건·또 1크레딧이 나왔어요. 서비스 랭킹 식으로는 17/20(85%)이고, 첫 페이지와 id 겹침은 14건이었어요. 페이지가 몇 분 만에 섞여요. 75%를 상수처럼 두지 마세요. 라이브 건수는 len(data.items)로 찍는 게 맞아요.

모르는 구절은 왜 인접 단어 쌍만 완화하나요?

스레드가 한 번도 들은 적 없는 구절은 빈 창을 돌려줘요. 기본값(expand 생략, true)은 그 구절을 인접 단어 쌍만 남기고 다시 쳐요. 단일어로 떨어지지는 않아요. 세 단어면 쌍이 최대 두 개예요. 단어 수 자체가 한도는 아니에요. 이미 통하는 구절은 쪼개지 않아요.

오늘 cari ai automation 봉투의 _warnings 원문은 이랬어요.

No Threads post matched "cari ai automation" as a phrase, so the query was expanded into 2 narrower searches (cari ai, ai automation) and 1 of them returned posts. Results are merged, de-duplicated and ordered by how many of your terms each post contains. You are billed 1 credit per search that returned posts, and an expanded response is a single page with no pagination cursor. Send expand=false to search the exact phrase only.

하위 검색은 cari ai와 ai automation 두 개예요. 게시물을 돌려준 다리는 1개라서 1크레딧이 찍혔어요. 본문 cari=0은 그 결과예요. 인도네시아어 「찾다」 단일어 다리가 빠졌기 때문에, 그 단어만 있는 글은 창에 안 섞여요. 그 단어가 있는 글은 놓치지만, 노이즈 창은 안 사요.

이미 통하는 세 단어는 경고가 없고, 커서가 있어요.

curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/threads/search?query=machine%20learning%20engineer"

curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/threads/search?query=ai%20automation%20agency"

machine learning engineer는 20건·1크레딧, _warnings 없음, has_more=true, 지연 3,195ms, request_id=req-XBrnbaOt9ttLTeJF예요. 첫 행 @codingmermaid.ai (https://www.threads.com/@codingmermaid.ai/post/C2-cI9ToQOQ)는 본문에 machine, learning, engineer가 모두 있고 좋아요 324예요. 세 단어 모두인 행은 이 페이지에서 11건이었어요.

ai automation agency도 20건·1크레딧, 확장 없음, 커서 있음, 지연 3,689ms, request_id=req-Sc5znEt3HlrQblbl예요. 본문 통단어 2개 이상은 14/20(70%)예요. 세 단어가 본문에 같이 있는 행으로는 @papoush_nd_ (https://www.threads.com/@papoush_nd_/post/DT_Co0cjg-y)가 있어요.

같은 쿼리를 몇 분 뒤 캐시가 끝난 창으로 다시 치면 길이가 달라질 수 있어요. machine learning engineer 콜드 재호출은 18건·1크레딧이었어요. 페이지 길이를 20으로 고정해 두지 마세요.

2026-09-04 글의 the best coffee는 단일어까지 내려가 3크레딧·44건이었어요. 그 이야기는 스레드 검색 API에 있어요. 오늘은 쌍만 남아요.

관련도가 오르면 크레딧은 어떻게 달라지나요?

SocialCrawl API 과금은 결과가 난 하위 검색당 1크레딧이에요. 빈 창은 0, 캐시 히트는 0이에요. 확장된 응답은 한 페이지고 커서가 없어요. 이 글의 1크레딧은 캐시가 안 맞은 봉투예요. 스레드 데이터 API를 리스닝에 물릴 때, 관련 없는 행을 사서 필터에 넣는 비용이 크레딧보다 클 때가 많아요. 관련도는 그 노이즈 창을 안 사는 쪽에 가까워요.

오늘 cari ai automation이 1크레딧인 이유는 단순해요. 인접 쌍 두 개 가운데 글을 돌려준 다리가 하나였거든요. 단일어까지 내려가면 결과가 난 다리마다 1이 붙어요. 오늘은 그 다리가 없어요.

오늘 찍힌 숫자는 이래요.

캐시 히트(req-rsupQRQlaNEsC9As)는 같은 20개 id를 410ms에 돌려주고 크레딧은 안 깎아요. 표준 호출의 크레딧은 호출당 크레딧을 보면 돼요.

출시 노트(2026-09-07)에는 같은 쿼리가 59건 중 15건(약 25%), 다리 4개·3크레딧으로 적혀 있어요. 오늘은 다시 잰 값이 아니에요. 오늘 표 왼쪽 칸으로 가져오지 않아요.

같은 1크레딧에 행이 더 붙는 일은 검색만의 이야기가 아니에요. 틱톡 API 1크레딧에 팔로워 150명은 팔로워·댓글 창을 같은 방식으로 쟀어요. 틱톡 숫자는 이 표에 섞지 않아요.

expand=false면 관련도 완화는 안 되나요?

정확 구절만 찾고 싶을 때는 expand=false를 붙이면 돼요. 관련도를 높이는 스위치예요. 건수를 늘리는 스위치가 아니에요.

curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/threads/search?query=cari%20ai%20automation&expand=false"

2026-09-08 00:14 UTC 응답은 게시물 0건, credits_used=0, cached=false, 지연 1,147ms, request_id=req-9e5zpulaoFDfH4WE예요.

{
  "success": true,
  "platform": "threads",
  "endpoint": "/v1/threads/search",
  "credits_used": 0,
  "cached": false,
  "request_id": "req-9e5zpulaoFDfH4WE",
  "pagination": {
    "has_more": false,
    "page_size": 0
  },
  "data": {
    "items": []
  }
}

스레드가 모르는 구절을 정확 구절로만 치면 빈 페이지고, 빈 페이지는 공짜예요. 기본 완화는 그 구절을 인접 쌍으로만 내려가요. 끄면 모르는 구절은 빈 창으로 끝나요.

더 받으려면 expand=false를 켜는 게 아니에요. 이미 통하는 구절로 검색하거나, 커서가 있는 창을 이어 걸면 돼요. 확장된 응답에는 커서가 없어요. 09-04 글이 the best coffee로 보여 준 0건 대 44건은 건수 글이에요. 여기는 입력 단어에 남을지, 정확 구절만 칠지예요.

짧은 단어 ai가 email 안에 점수를 주나요?

짧은 알파벳 단어는 긴 단어 안에 부분문자열로 들어가기 쉬워요. ai가 email이나 rain, said 통단어에 점수를 주면 관련도 식이 오염돼요. 오늘은 그 세 호스트 단어가 있는 페이지를 치지 못했어요. 관측만 적어요.

query=ai는 2026-09-08 00:16 UTC 영문 측정에서 받은 페이지를 재사용했어요. 이 측정에서는 다시 치지 않았어요. 17건, 1크레딧, 3,900ms, has_more=true, request_id=req-9tKz9dPbgkYe1CL0이었어요.

호스트 단어 오탐을 오늘 17건에서 재현하지는 못했어요. 없는 오탐을 있는 것처럼 쓰지 않아요. 부분문자열만인 행 1건의 토큰은 Aiman과 maintain이지 email이 아니에요. @meor.store (https://www.threads.com/@meor.store/post/Dc_-dX9kwRM) 본문은 "Syahmie dan Luqman dibawah Aiman…"이고, 토픽 태그는 AI team이었어요.

한국어 행도 있어요. @_artist1225_ (https://www.threads.com/@_artist1225_/post/DdAEaQXE4_I)는 토픽 태그 AI Threads, language=ko, 본문은 「아스트라와 함께 돌아온 티보형에게 티: 티보형! 보: 보너스로 한 장만 더…」예요. 통단어 ai는 없어요. 헤드라인 식에서는 분자에 안 들어가요. 분모에는 들어가요.

고쳤다고 단정하려면 email / rain / said가 본문에 있는 페이지가 필요해요. 오늘은 그 페이지가 아니에요.

같은 봉투를 받으려면요?

1. SocialCrawl에 가입하고 API 키를 받아요. 무료 크레딧이 따라와요.
2. 최소 재현은 헤드라인 쿼리예요. 키만 바꿔서 같은 봉투를 볼 수 있어요.

curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/threads/search?query=cari%20ai%20automation"

봉투의 credits_used와 _warnings가 같은 완화(인접 쌍 두 개, 과금 다리 하나)를 보여 주고, data.items 길이로 페이지를 세면 돼요. 영문으로 threads search api를 찾아도 호출은 이 엔드포인트예요.

3. 그다음은 Threads 플랫폼 허브에서 엔드포인트 목록을 보세요. 코드 한 줄 쓰기 전에 비주얼 익스플로러로 응답 모양을 먼저 확인해 보세요. 인증·봉투 규칙은 API 문서를 보세요.

이 글에 나온 숫자는 2026-09-08 00:14–00:20 UTC 실측이에요. 이 측정 과금은 3크레딧이었어요. 캐시 히트 0+0, expand=false 0, 콜드 재호출 1+1+1. 라이브 건수는 움직일 수 있어요. 한 창은 대략 15–20건이고, 오늘 창은 17, 18, 20이 섞여 있어요.

게시·OAuth·앱 심사가 궁금하면 스레드 API를 보세요. 창을 이어 몇 건인지, limit으로 55건을 모은 표는 스레드 검색 API 쪽이에요.

자주 묻는 질문

스레드 키워드 검색 관련도는 어떻게 재나요?

본문 post.content.text에서 쿼리 단어를 양쪽 경계 통단어로 세고, 2개 이상인 행을 len(data.items)로 나눈 값이에요. 오늘 헤드라인은 15/20=75%예요. 토픽 태그와 인용문은 분자에서 빼요. 같은 날 콜드 재호출은 서비스 랭킹 식으로 17/20이었어요. 75%를 상수로 두지 마세요.

짧은 단어 ai가 email 안에 매칭되던 문제는 고쳤나요?

오늘 query=ai 17건에서 통단어 email / rain / said는 0이었어요. 부분문자열 1건은 Aiman / maintain이고, 호스트 단어가 아니에요. 그 세 호스트 단어가 있는 페이지를 오늘 못 쳐서 「고쳤다」고 단정하지 않아요.

세 단어 구절은 항상 쪼개지나요?

아니요. machine learning engineer는 20건·1크레딧·_warnings 없음이에요. ai automation agency도 20건·1크레딧이에요. 단어 수가 한도가 아니에요. 스레드가 모르는 구절만 인접 쌍으로 내려가요.

Threads가 모르는 구절을 넣으면 과금되나요?

expand=false면 0건·0크레딧이에요. 기본 완화는 게시물을 돌려준 쌍만 1크레딧이에요. 오늘 cari ai automation은 쌍 2개 중 1개가 글을 줘서 1크레딧이었어요.

기본 완화와 expand=false는 관련도에서 뭐가 다른가요?

기본값은 모르는 구절을 인접 쌍으로 나눠 합치고, 입력 단어 개수로 정렬하고, 커서가 없어요. expand=false는 정확 구절만 쳐요. 관련도를 높이는 스위치이지 건수를 늘리는 스위치가 아니에요.

limit=50 이상에서 타임아웃이 나는 이유는요?

오늘 측정에는 limit 호출이 없어요. 출시 노트(2026-09-07) 라벨만 적어요. 창은 당시 약 3.4초씩 순차였고, limit=50은 10.2초라 기본 HTTP 10초 클라이언트가 먼저 죽어요. 타임아웃을 올리거나, 작은 limit에 pagination.next_cursor를 붙이면 돼요. 55건 표는 스레드 검색 API에 있어요.

이 글과 스레드 검색 API 글은 뭐가 다른가요?

그 글은 한 호출 건수(55)이고, 이 글은 입력 단어에 머무르는 비율(15/20, 쌍만, 짧은 단어)이에요.