# solari instagram brand lookalike content

> Posts that look and read like a brand's best-performing ads.

- **CLI**: `solari instagram brand lookalike content`
- **MCP tool**: `solari_instagram_brand_lookalike_content`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.

Instagram posts visually and semantically similar to the brand's top-performing sponsored ads, found via vector-neighbour search seeded from the brand's own ad posts. Identify the brand by account_id (SOLARI account UUID from solari_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account.

**When to use it** — Reference hunting. Vector-neighbour search seeded from the brand's own top ads.

**What comes back** — The lookalike posts, plus the brand's own ads that seeded the search.

## Parameters

- `account_id` (string, optional, uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$) — Brand account_id (SOLARI account UUID) whose sponsored ads seed the lookalike search. Provide this or username.
- `username` (string, optional, ≤ 64 chars) — Brand Instagram handle, with or without a leading @. Ignored when account_id is set.
- `limit` (integer, optional, ≥ 1) — Maximum lookalike posts returned, default 30. Values above 50 are clamped to 50.
- `region` (string, optional, default "KR") — Region code such as KR, JP, or US scoping the search.

## Response

### `Response`

- `items` (object[]) — Lookalike posts.
- `basis` (object[]) — The brand's own ad posts used as seeds.
- `region` (string) — Region the search was scoped to.

### `items[] · basis[]`

- `post_id` (uuid) — SOLARI post id. Feed it straight into the other content tools.
- `slug` (string) — Instagram shortcode — the segment after /p/ or /reel/ in a public URL.
- `author_id` (uuid) — account_id of the authoring account.
- `username` (string) — Author handle.
- `full_name` (string | null) — Profile display name.
- `profile_pic_url` (string | null) — Profile picture URL.
- `follower_count` (integer | null) — Author follower count at snapshot time.
- `region` (string | null) — Region code assigned to the author.
- `posted_at` (timestamp) — Publication time (UTC).
- `media_type` (string) — image, video, or carousel.
- `play_count` (integer | null) — Video plays. null for image posts.
- `like_count` (integer | null) — Likes at snapshot time.
- `text` (string | null) — Caption text.
- `media_url` (string) — Original media URL.
- `thumbnail_url` (string) — Thumbnail URL.
- `score` (number | null) — Feed ranking score. Comparable only within one response.
- `efficiency_score` (number | null) — Performance relative to the author's follower count.
- `est_percentile` (number | null) — Estimated percentile within the region, 0–1.
- `total_views_3m` (integer | null) — Author's cumulative views over the last 3 months.
- `median_views_3m` (integer | null) — Author's median views over the last 3 months.
- `recent_collab_brands` (string[]) — Brands the author has collaborated with recently.
- `item_type` (string) — Item kind tag; post in the content feeds.
- `content_source` (string | null) — Which pipeline surfaced this item.
- `is_saved` (boolean | null) — Whether the item is saved in the SOLARI app.
- `updated_at` (timestamp | null) — When the metric snapshot was last refreshed.

## Example

```console
$ solari instagram brand lookalike content username=innisfreeofficial limit=3
```

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "items": [
    {
      "item_type": "content",
      "post_id": "019ecb92-a677-7421-8ed6-752efe3d99d0",
      "author_id": "0196cb39-870a-7a76-9773-0b95789c877d",
      "username": "boo_rookie",
      "full_name": null,
      "profile_pic_url": null,
      "follower_count": null,
      "region": null,
      "posted_at": "2026-06-11T08:14:37Z",
      "media_type": "video",
      "play_count": 427258,
      "like_count": null,
      "score": null,
      "efficiency_score": null,
      "est_percentile": null,
      "updated_at": null,
      "media_url": "https://smr-images-b.bzine.co/users/0196cb39-870a-7a76-9773-0b95789c877d/posts/019ecb92-a677-7421-8ed6-752efe3d99d0/medias/019ecb92-a92e-7fc8-b644-69b930f2e197.mp4",
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images-a.bzine.co/users/0196cb39-870a-7a76-9773-0b95789c877d/posts/019ecb92-a677-7421-8ed6-752efe3d99d0/medias/019ecb92-a92e-7fc8-b644-69b930f2e1 …",
      "slug": "DZcD8KXxKwd",
      "text": null,
      "brand_match_score": null,
      "recent_collab_brands": [],
      "total_views_3m": null,
      "median_views_3m": null,
      "is_saved": null,
      "content_source": "lookalikes_by_top_ad"
    },
    "… 2 more"
  ],
  "basis": [
    {
      "item_type": "content",
      "post_id": "01a04c73-3ec3-7873-9e84-334c644abfe4",
      "author_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
      "username": "hwitto_",
      "full_name": null,
      "profile_pic_url": null,
      "follower_count": null,
      "region": null,
      "posted_at": null,
      "media_type": "video",
      "play_count": 155729,
      "like_count": null,
      "score": null,
      "efficiency_score": null,
      "est_percentile": null,
      "updated_at": null,
      "media_url": "https://smr-images-a.bzine.co/users/0196c474-c96e-71ad-aceb-61af051c81d3/posts/01a04c73-3ec3-7873-9e84-334c644abfe4/medias/01a04c73-4036-7a83-a52a-97b0058e6732.mp4",
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images.bzine.co/users/0196c474-c96e-71ad-aceb-61af051c81d3/posts/01a04c73-3ec3-7873-9e84-334c644abfe4/medias/01a04c73-4036-7a83-a52a-97b0058e6732 …",
      "slug": "DckGrZ6vZiU",
      "text": null,
      "brand_match_score": null,
      "recent_collab_brands": [],
      "total_views_3m": null,
      "median_views_3m": null,
      "is_saved": null,
      "content_source": "lookalikes_by_top_ad"
    },
    "… 5 more"
  ],
  "region": "KR"
}
```

## As an MCP call

```json
{
  "name": "solari_instagram_brand_lookalike_content",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 3
  }
}
```

## Notes

- limit is clamped at 50.
- An empty basis means the brand has no ad posts to seed from yet.

## Related tools

- [`solari_instagram_brand_ad_posts`](https://solari.sh/docs/tools/instagram-brand-ad-posts.md)
- [`solari_instagram_content_search`](https://solari.sh/docs/tools/instagram-content-search.md)