> ## 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 posts > Find posts with a semantic query and structured filters; returns post summaries. Searches what Klint tracks for posts. Returns fixed-shape [post summaries](/docs/instagram/search/posts-search#reading-the-results) in relevance order (query-bearing) or optional sorted order (filters-only). ## Request body | Field | Type | Notes | | -------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `post` | object, **required** | The post scope | | `post.query` | string | Natural-language content intent, โ‰ค 2,000 chars. Supplies relevance ordering | | `post.filters` | object | [Post filter fields](/docs/instagram/search/posts-search#post-filter-fields); operator objects only | | `post.author` | object | `{ "filters": ... }`: [author filters](/docs/instagram/search/posts-search#author-filters) that constrain the account that published the post | | `sort` | object | `{ "by", "order" }`. Filters-only requests only; Klint rejects it with a query | | `limit` | integer | 1โ€“100, default 20 | | `cursor` | string | Continuation: send only `cursor` + optional same-or-lower `limit` | An initial request needs at least one non-empty `query` or filter scope. Complete grammar, limits, and invalid-request examples: [Search posts โ€บ filtering](/docs/instagram/search/posts-search#filter-the-results). ## Examples Query-bearing: ```json theme={null} { "post": { "query": "UGC-style grooming-product demonstrations", "filters": { "posted_at": { "gte": "2026-06-01T00:00:00Z" }, "format": { "in": ["reel"] } }, "author": { "filters": { "followers_count": { "gte": 5000, "lte": 50000 }, "niches": { "contains_any": ["pets"] } } } }, "limit": 10 } ``` ```json theme={null} { "request_id": "req_example_01", "data": [ { "id": "ig_post_8f3k2", "shortcode": "DLm2XwYv4Qk", "web_url": "https://www.instagram.com/reel/DLm2XwYv4Qk/", "posted_at": "2026-07-06T14:02:00Z", "observed_at": "2026-07-14T16:10:00Z", "format": "reel", "primary_language": "en", "caption": "The brush that finally fixed our shedding problem ๐Ÿ• One week of daily passes and the couch is fur-free. Grab 20% off with code GROOM20 โ€” link in bio. #doggrooming", "hashtags": [ "doggrooming" ], "caption_mentions": [], "audio": { "id": "ig_audio_7m4q", "instagram_id": "587784541076604", "type": "music", "title": "Birthday Wish", "attribution": { "display_name": "Shuba", "account": null }, "duration_seconds": 153.76, "web_url": "https://www.instagram.com/reels/audio/587784541076604/" }, "content_summary": "A creator demonstrates a deshedding brush on a dog, describes a less-messy grooming routine, shows the result, and directs viewers to a discount in the Account bio.", "topics": [ "dog_grooming", "at_home_pet_care" ], "creative_formats": [ "talking_head", "product_demonstration", "creator_testimonial" ], "hook": { "construction": "The creator holds the brush beside a visibly shedding dog, states that it changed the grooming routine, and displays a seven-day result claim.", "devices": [ "problem_callout", "direct_promise" ], "modalities": [ "visual", "spoken", "on_screen_text" ] }, "key_messages": [ { "summary": "The brush is presented as making at-home shedding cleanup easier.", "roles": [ "claim", "benefit", "use_case" ], "presentation": "asserted" } ], "proofs": [ { "summary": "The creator demonstrates brushing the dog and shows the collected hair.", "mechanisms": [ "live_product_demonstration", "result_reveal" ], "cited_source_types": [] } ], "offers": [ { "summary": "20% off with a stated promo code.", "types": [ "discount", "promo_code" ], "stated_terms": [ "20% off", "GROOM20" ] } ], "calls_to_action": [ { "summary": "Use the link in the Account bio.", "actions": [ "visit_profile_link" ], "stages": [ "closing" ], "modalities": [ "spoken", "on_screen_text", "caption" ] } ], "narrative_structure": { "description": "Problem framing, product demonstration, result reveal, then offer and CTA.", "patterns": [ "problem_solution", "demonstration_to_result", "offer_close" ] }, "has_paid_partnership_label": false, "paid_partners": [], "commercial_contexts": [ "promo_code", "seller_behavior" ], "comments_enabled": true, "views": 412000, "likes": 28600, "comments": 354, "engagement_rate_by_views": 0.0703, "view_ratio_to_account_baseline": 6.2, "author": { "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", "followers_count": 21400, "is_verified": false }, "coauthors": [] }, { "id": "ig_post_9m3t", "shortcode": "DMq7RwXk2Pd", "web_url": "https://www.instagram.com/reel/DMq7RwXk2Pd/", "posted_at": "2026-06-24T19:15:00Z", "observed_at": "2026-07-14T13:40:00Z", "format": "reel", "primary_language": "en", "caption": "POV: shedding season with a husky ๐Ÿ˜… This grooming glove is the only thing keeping our couch alive. #huskylife #sheddingseason #doggrooming", "hashtags": [ "huskylife", "sheddingseason", "doggrooming" ], "caption_mentions": [], "audio": { "id": "ig_audio_2b8c", "instagram_id": null, "type": "original_sound", "title": "Original audio", "attribution": { "display_name": "brodyandbear", "account": { "id": "ig_account_3d6p", "handle": "brodyandbear", "display_name": "Brody & Bear", "web_url": "https://www.instagram.com/brodyandbear/", "avatar_url": "https://media.tryklint.ai/accounts/ig_account_3d6p/avatar", "followers_count": 12400, "is_verified": false } }, "duration_seconds": 18.9, "web_url": null }, "content_summary": "A dog owner films a casual at-home demonstration of a grooming glove on a shedding husky, showing the removed undercoat and joking about protecting the couch.", "topics": [ "dog_grooming", "at_home_pet_care" ], "creative_formats": [ "product_demonstration" ], "hook": { "construction": "A point-of-view framing of shedding season opens on a husky mid-shed before the owner pulls out the grooming glove.", "devices": [ "relatable_scenario" ], "modalities": [ "visual", "on_screen_text" ] }, "key_messages": [ { "summary": "The grooming glove is presented as an easy way to control husky shedding at home.", "roles": [ "claim", "benefit" ], "presentation": "asserted" } ], "proofs": [ { "summary": "The owner demonstrates the glove on the husky and shows the removed fur.", "mechanisms": [ "live_product_demonstration", "result_reveal" ], "cited_source_types": [] } ], "offers": [], "calls_to_action": [], "narrative_structure": null, "has_paid_partnership_label": false, "paid_partners": [], "commercial_contexts": [], "comments_enabled": true, "views": 156000, "likes": 9800, "comments": 412, "engagement_rate_by_views": 0.0655, "view_ratio_to_account_baseline": null, "author": { "id": "ig_account_3d6p", "handle": "brodyandbear", "display_name": "Brody & Bear", "web_url": "https://www.instagram.com/brodyandbear/", "avatar_url": "https://media.tryklint.ai/accounts/ig_account_3d6p/avatar", "followers_count": 12400, "is_verified": false }, "coauthors": [] } ], "has_more": false, "next_cursor": null } ``` Filters-only with sort: ```json theme={null} { "post": { "filters": { "posted_at": { "gte": "2026-06-01T00:00:00Z" }, "format": { "in": ["reel"] } }, "author": { "filters": { "followers_count": { "gte": 5000, "lte": 50000 } } } }, "sort": { "by": "views", "order": "desc" }, "limit": 10 } ``` ```json theme={null} { "request_id": "req_example_02", "data": [ { "id": "ig_post_8f3k2", "shortcode": "DLm2XwYv4Qk", "web_url": "https://www.instagram.com/reel/DLm2XwYv4Qk/", "posted_at": "2026-07-06T14:02:00Z", "observed_at": "2026-07-14T16:10:00Z", "format": "reel", "primary_language": "en", "caption": "The brush that finally fixed our shedding problem ๐Ÿ• One week of daily passes and the couch is fur-free. Grab 20% off with code GROOM20 โ€” link in bio. #doggrooming", "hashtags": [ "doggrooming" ], "caption_mentions": [], "audio": { "id": "ig_audio_7m4q", "instagram_id": "587784541076604", "type": "music", "title": "Birthday Wish", "attribution": { "display_name": "Shuba", "account": null }, "duration_seconds": 153.76, "web_url": "https://www.instagram.com/reels/audio/587784541076604/" }, "content_summary": "A creator demonstrates a deshedding brush on a dog, describes a less-messy grooming routine, shows the result, and directs viewers to a discount in the Account bio.", "topics": [ "dog_grooming", "at_home_pet_care" ], "creative_formats": [ "talking_head", "product_demonstration", "creator_testimonial" ], "hook": { "construction": "The creator holds the brush beside a visibly shedding dog, states that it changed the grooming routine, and displays a seven-day result claim.", "devices": [ "problem_callout", "direct_promise" ], "modalities": [ "visual", "spoken", "on_screen_text" ] }, "key_messages": [ { "summary": "The brush is presented as making at-home shedding cleanup easier.", "roles": [ "claim", "benefit", "use_case" ], "presentation": "asserted" } ], "proofs": [ { "summary": "The creator demonstrates brushing the dog and shows the collected hair.", "mechanisms": [ "live_product_demonstration", "result_reveal" ], "cited_source_types": [] } ], "offers": [ { "summary": "20% off with a stated promo code.", "types": [ "discount", "promo_code" ], "stated_terms": [ "20% off", "GROOM20" ] } ], "calls_to_action": [ { "summary": "Use the link in the Account bio.", "actions": [ "visit_profile_link" ], "stages": [ "closing" ], "modalities": [ "spoken", "on_screen_text", "caption" ] } ], "narrative_structure": { "description": "Problem framing, product demonstration, result reveal, then offer and CTA.", "patterns": [ "problem_solution", "demonstration_to_result", "offer_close" ] }, "has_paid_partnership_label": false, "paid_partners": [], "commercial_contexts": [ "promo_code", "seller_behavior" ], "comments_enabled": true, "views": 412000, "likes": 28600, "comments": 354, "engagement_rate_by_views": 0.0703, "view_ratio_to_account_baseline": 6.2, "author": { "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", "followers_count": 21400, "is_verified": false }, "coauthors": [] }, { "id": "ig_post_9m3t", "shortcode": "DMq7RwXk2Pd", "web_url": "https://www.instagram.com/reel/DMq7RwXk2Pd/", "posted_at": "2026-06-24T19:15:00Z", "observed_at": "2026-07-14T13:40:00Z", "format": "reel", "primary_language": "en", "caption": "POV: shedding season with a husky ๐Ÿ˜… This grooming glove is the only thing keeping our couch alive. #huskylife #sheddingseason #doggrooming", "hashtags": [ "huskylife", "sheddingseason", "doggrooming" ], "caption_mentions": [], "audio": { "id": "ig_audio_2b8c", "instagram_id": null, "type": "original_sound", "title": "Original audio", "attribution": { "display_name": "brodyandbear", "account": { "id": "ig_account_3d6p", "handle": "brodyandbear", "display_name": "Brody & Bear", "web_url": "https://www.instagram.com/brodyandbear/", "avatar_url": "https://media.tryklint.ai/accounts/ig_account_3d6p/avatar", "followers_count": 12400, "is_verified": false } }, "duration_seconds": 18.9, "web_url": null }, "content_summary": "A dog owner films a casual at-home demonstration of a grooming glove on a shedding husky, showing the removed undercoat and joking about protecting the couch.", "topics": [ "dog_grooming", "at_home_pet_care" ], "creative_formats": [ "product_demonstration" ], "hook": { "construction": "A point-of-view framing of shedding season opens on a husky mid-shed before the owner pulls out the grooming glove.", "devices": [ "relatable_scenario" ], "modalities": [ "visual", "on_screen_text" ] }, "key_messages": [ { "summary": "The grooming glove is presented as an easy way to control husky shedding at home.", "roles": [ "claim", "benefit" ], "presentation": "asserted" } ], "proofs": [ { "summary": "The owner demonstrates the glove on the husky and shows the removed fur.", "mechanisms": [ "live_product_demonstration", "result_reveal" ], "cited_source_types": [] } ], "offers": [], "calls_to_action": [], "narrative_structure": null, "has_paid_partnership_label": false, "paid_partners": [], "commercial_contexts": [], "comments_enabled": true, "views": 156000, "likes": 9800, "comments": 412, "engagement_rate_by_views": 0.0655, "view_ratio_to_account_baseline": null, "author": { "id": "ig_account_3d6p", "handle": "brodyandbear", "display_name": "Brody & Bear", "web_url": "https://www.instagram.com/brodyandbear/", "avatar_url": "https://media.tryklint.ai/accounts/ig_account_3d6p/avatar", "followers_count": 12400, "is_verified": false }, "coauthors": [] }, { "id": "ig_post_3p7d", "shortcode": "DMxR4kWq9Ln", "web_url": "https://www.instagram.com/reel/DMxR4kWq9Ln/", "posted_at": "2026-06-18T17:30:00Z", "observed_at": "2026-07-14T11:05:00Z", "format": "reel", "primary_language": "en", "caption": "The deshedding mistake I see every week in the salon ๐Ÿ™ˆ Try this instead (works with any slicker brush).\n\n#groomingtips #deshedding", "hashtags": [ "groomingtips", "deshedding" ], "caption_mentions": [], "audio": null, "content_summary": "A professional groomer demonstrates a common deshedding mistake on a client dog, then shows a corrected slicker-brush technique and the reduced coat damage.", "topics": [ "dog_grooming" ], "creative_formats": [ "talking_head", "product_demonstration" ], "hook": { "construction": "The groomer names a mistake she sees weekly in the salon while showing the matted result on a client dog.", "devices": [ "problem_callout" ], "modalities": [ "visual", "spoken" ] }, "key_messages": [ { "summary": "Brushing direction and pressure matter more than the specific brush.", "roles": [ "claim", "use_case" ], "presentation": "asserted" } ], "proofs": [ { "summary": "The groomer demonstrates both techniques on the same dog and compares the results.", "mechanisms": [ "live_product_demonstration" ], "cited_source_types": [] } ], "offers": [], "calls_to_action": [ { "summary": "Follow for weekly grooming technique tips.", "actions": [ "follow_account" ], "stages": [ "closing" ], "modalities": [ "spoken" ] } ], "narrative_structure": null, "has_paid_partnership_label": false, "paid_partners": [], "commercial_contexts": [], "comments_enabled": true, "views": 89400, "likes": 5210, "comments": 154, "engagement_rate_by_views": 0.06, "view_ratio_to_account_baseline": null, "author": { "id": "ig_account_9t4w", "handle": "groomwithgrace", "display_name": "Grace | Groom With Grace", "web_url": "https://www.instagram.com/groomwithgrace/", "avatar_url": "https://media.tryklint.ai/accounts/ig_account_9t4w/avatar", "followers_count": 18900, "is_verified": false }, "coauthors": [] } ], "has_more": false, "next_cursor": null } ``` ## Response `{ "request_id", "data": [PostSummary], "has_more", "next_cursor" }`. Each item is the complete post summary: identity, authored content, creative interpretation, commercial context, current metrics, embedded author summary. Null semantics and progressive enrichment: [reading the results](/docs/instagram/search/posts-search#reading-the-results). ## Errors `422 validation-failed` (bad grammar, [all cases](/docs/instagram/search/posts-search#what-gets-rejected)) ยท `410 expired-cursor` ยท `429 rate-limit-exceeded` ยท [full catalog](/docs/api-reference/errors).