> ## Documentation Index
> Fetch the complete documentation index at: https://tryklint.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Fetch /llms.txt for the complete page index before exploring further. Every docs page is available as markdown by appending .md to its URL. Coding agents should start at /for-agents/coding-agents.md.

# Search accounts

> Find accounts by current observed identity with filters and a related-posts scope.

Searches what Klint tracks for accounts. Returns the same fixed [account representation](/docs/instagram/search/accounts-search#reading-the-results) as Get account. There is no reduced search card.

## Request body

| Field                                  | Type                 | Notes                                                                                                       |
| -------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------- |
| `account`                              | object, **required** | The account scope                                                                                           |
| `account.query`                        | string               | Identity intent, ≤ 2,000 chars. [Qualification rules](/docs/instagram/search/accounts-search#query-the-identity) |
| `account.filters`                      | object               | [Account filter fields](/docs/instagram/search/accounts-search#account-filter-fields)                            |
| `account.posts`                        | object               | Publishing scope: `minimum_matching_posts` + `filters`                                                      |
| `account.posts.minimum_matching_posts` | integer              | 1–3 (provisional max); distinct posts each satisfying the **complete** `account.posts.filters` predicate    |
| `account.posts.filters`                | object               | [Post filter fields](/docs/instagram/search/posts-search#post-filter-fields)                                     |
| `sort`                                 | object               | Filters-only requests only                                                                                  |
| `limit`                                | integer              | 1–100, default 20                                                                                           |
| `cursor`                               | string               | Continuation: cursor only + optional same-or-lower `limit`                                                  |

<Note>
  Open contract items: whether `account.posts` also counts accepted-coauthor posts, and the `minimum_matching_posts` maximum (a 5-post benchmark is pending).
</Note>

## Examples

Identity query with a posts scope:

```json theme={null}
{
  "account": {
    "query": "sporty stay-at-home moms",
    "filters": {
      "followers_count": {
        "gte": 5000,
        "lte": 50000
      }
    },
    "posts": {
      "minimum_matching_posts": 3,
      "filters": {
        "posted_at": {
          "gte": "2026-04-01T00:00:00Z",
          "lt": "2026-07-01T00:00:00Z"
        }
      }
    }
  },
  "limit": 10
}
```

<Accordion title="200 response">
  ```json theme={null}
  {
    "request_id": "req_example_03",
    "data": [
      {
        "id": "ig_account_01j2k9m4q7",
        "handle": "mayamoveswell",
        "display_name": "Maya | Family Wellness",
        "web_url": "https://www.instagram.com/mayamoveswell/",
        "avatar_url": "https://media.tryklint.ai/accounts/ig_account_01j2k9m4q7/avatar",
        "biography": "Sporty stay-at-home mom sharing practical kids gut-health and family-wellness tips. Spokane, WA.",
        "bio_links": [
          {
            "url": "https://mayamoveswell.example/resources",
            "title": "Free family wellness guides"
          }
        ],
        "account_type": "creator",
        "category_label": "Health/beauty",
        "declared_locations": [
          {
            "country_code": "US",
            "region_code": "US-WA",
            "locality": "Spokane"
          }
        ],
        "is_verified": false,
        "is_private": false,
        "followers_count": 24300,
        "following_count": 684,
        "posts_count": 418,
        "publishing_summary": "Shares practical family-wellness education through at-home fitness routines, simple meal preparation, and recurring explanations of children's gut health.",
        "publishing_languages": [
          "en"
        ],
        "niches": [
          "family_wellness",
          "gut_health",
          "home_fitness"
        ],
        "observed_at": "2026-07-15T15:40:00Z"
      }
    ],
    "has_more": false,
    "next_cursor": null
  }
  ```
</Accordion>

Filters-only:

```json theme={null}
{
  "account": {
    "filters": {
      "followers_count": {
        "gte": 5000,
        "lte": 50000
      },
      "niches": {
        "contains_any": ["pets"]
      }
    },
    "posts": {
      "minimum_matching_posts": 1,
      "filters": {
        "posted_at": {
          "gte": "2026-05-01T00:00:00Z",
          "lt": "2026-07-01T00:00:00Z"
        },
        "views": {
          "gte": 200000
        }
      }
    }
  },
  "sort": {
    "by": "followers_count",
    "order": "desc"
  },
  "limit": 10
}
```

<Accordion title="200 response">
  ```json theme={null}
  {
    "request_id": "req_example_04",
    "data": [
      {
        "id": "ig_account_2j1x",
        "handle": "dogmomdaily",
        "display_name": "Dog Mom Daily",
        "web_url": "https://www.instagram.com/dogmomdaily/",
        "avatar_url": "https://media.tryklint.ai/accounts/ig_account_2j1x/avatar",
        "biography": "Golden retriever mom sharing real-life grooming and shedding hacks 🐾",
        "bio_links": [
          {
            "url": "https://dogmomdaily.example/favorites",
            "title": "Our favorite grooming tools"
          }
        ],
        "account_type": "creator",
        "category_label": "Blogger",
        "declared_locations": [],
        "is_verified": false,
        "is_private": false,
        "followers_count": 21400,
        "following_count": 512,
        "posts_count": 267,
        "publishing_summary": "Documents at-home dog care through grooming-product demonstrations, shedding-management routines, and day-in-the-life content with a golden retriever.",
        "publishing_languages": [
          "en"
        ],
        "niches": [
          "pets",
          "dog_care"
        ],
        "observed_at": "2026-07-15T09:20:00Z"
      }
    ],
    "has_more": false,
    "next_cursor": null
  }
  ```
</Accordion>

## Response

`{ "request_id", "data": [Account], "has_more", "next_cursor" }`. Klint never returns confirmed-private accounts. Field semantics: [reading the results](/docs/instagram/search/accounts-search#reading-the-results).

## Errors

`422 validation-failed` ([all cases](/docs/instagram/search/accounts-search#what-gets-rejected)) · `410 expired-cursor` · `429 rate-limit-exceeded` · [full catalog](/docs/api-reference/errors).