instagram · contentsolari:read

solari instagram content search

Keyword search across captions, creator bios, and video transcriptions.

MCP tool: solari_instagram_content_search
CLI: solari instagram content search
Access: solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.

Overview

Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_instagram_content_detail or solari_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account.

When to use it — Finding posts by topic or phrasing. When the answer is a count, use content aggregate instead.

What comes back — Relevance-ranked hits with match highlights.

Parameters

querystringrequired: Free-text keyword query matched against captions, creator bios, and video transcriptions.
regionenumoptional: Region to search. Only these four regions are indexed.default "KR"ValuesKRJPUSTW
limitintegeroptional: Maximum hits, default 20. Values above 100 are clamped to 100.≥ 1
offsetintegeroptional: Pagination offset, default 0.default 0≥ 0
sincestringoptional: Only posts on or after this UTC date, YYYY-MM-DD inclusive. Data older than ~6 months is not indexed.pattern ^\d{4}-\d{2}-\d{2}$
untilstringoptional: Only posts on or before this UTC date, YYYY-MM-DD inclusive.pattern ^\d{4}-\d{2}-\d{2}$

Response

query / regionstring: The query and region applied.
totalinteger: Total matches. Exact up to 10,000, then saturates.
took_msinteger: Search time.
itemsobject[]: Hits, score descending.

items[]

post_iduuid: SOLARI post id.
slugstring: Instagram shortcode.
account_id / author_id / usernamestring: Authoring account. account_id is the current name.
captionstring: Caption text.
user_biostring: Author bio — part of the searched text.
transcription_textstring | null: Video speech transcription.
posted_attimestamp: Publication time (UTC).
like_count / comment_countinteger: Engagement snapshot.
follower_countinteger: Author follower count.
scorenumber: Relevance score. Comparable only within this response.
highlightobject: Matched fragments per field: caption, user_bio, transcription_text.
is_videoboolean: Whether the post is a video.

Example

Request

$ solari instagram content search query="이니스프리 그린티" limit=3

Response · Long strings and repeated array entries are trimmed for readability.

{
  "query": "이니스프리 그린티",
  "region": "KR",
  "total": 10000,
  "took_ms": 1586,
  "items": [
    {
      "post_id": "019f12d8-3e72-78e9-b7e5-39293bc56f23",
      "author_id": "019f12d8-3e0f-7c74-afc6-e14405bd1523",
      "username": "hanydiary",
      "caption": "[이니스프리에디터 4기 1-2 : 그린티 PDRN 아이&립 세럼] #이니스프리 #그린티PDRN 💚 자세한 포스팅은 프로필 링크 참고해주세요 :)",
      "user_bio": "대외활동 | 휴학생 | 취준일기 🪽과 학생회 2년 연임 🪽이니스프리 대학생 에디터 3기 / 4기",
      "transcription_text": null,
      "posted_at": "2026-02-16T05:44:45Z",
      "like_count": 3,
      "comment_count": 3,
      "follower_count": 972,
      "score": 140.43787,
      "slug": "DUzrl1UkoJb",
      "highlight": {
        "caption": [
          "[<mark>이니스프리</mark>에디터 4기 1-2 : <mark>그린티</mark> PDRN 아이&립 세럼] #이니스프리 #그린티PDRN 💚 자세한 포스팅은 프로필 링크 참고해주세요 :)"
        ],
        "user_bio": [
          "대외활동 | 휴학생 | 취준일기 🪽과 학생회 2년 연임 🪽<mark>이니스프리</mark> 대학생 에디터 3기 / 4기"
        ],
        "transcription_text": []
      },
      "is_video": false,
      "media_url": null,
      "thumbnail_url": null,
      "account_id": "019f12d8-3e0f-7c74-afc6-e14405bd1523"
    },
    "… 2 more"
  ]
}

As an MCP call

{
  "name": "solari_instagram_content_search",
  "arguments": {
    "query": "이니스프리 그린티",
    "limit": 3
  }
}

Notes

The index covers KR, JP, US, and TW only, holding roughly the most recent 6 months. A since older than that returns nothing.
total is exact up to 10,000 and stops there.
Korean-aware analysis is combined with n-gram partial matching.

Machine-readable: /docs/tools/instagram-content-search.md

Overview

Parameters

Response

Example

Notes

Related tools