Instagram Search Posts
Discover public Instagram post URLs through web search pagination, then crawl each discovered URL into normalized post detail in one response.
Try on PlaygroundAuthentication
Send your Crawlkit API key as a Bearer token in the Authorization header.
Authorization: Bearer ck_your_api_keyRequest Parameters
Send these JSON body fields in your request payload.
| Name | Type | Description |
|---|---|---|
query | string | Search query text. |
cursor | null | Pagination cursor. |
options.region | string | Region code. |
options.maxResults | number | Maximum result count. |
options.timeRange | string | Recency filter. |
Example Request
Use direct HTTP requests against the public API base URL.
Example request
1const response = await fetch('https://api.crawlkit.sh/v1/crawl/instagram/search-posts', {2 method: 'POST',3 headers: {4 'Authorization': 'Bearer YOUR_API_KEY',5 'Content-Type': 'application/json'6 },7 body: JSON.stringify({8 query: 'healthy breakfast ideas',9 cursor: null,10 options: {11 region: 'us-en',12 maxResults: 10,13 timeRange: 'm',14 }15 })16});17 18const { data } = await response.json();19console.log(data.results[0]?.post?.shortcode, data.pagination?.nextCursor);Response
Success (200 OK): Returns service-specific structured payload.
Success response (200 OK)
1{2 "success": true,3 "data": {4 "query": "healthy breakfast ideas",5 "results": [6 {7 "position": 1,8 "title": "Healthy breakfast ideas • Instagram post",9 "url": "https://www.instagram.com/p/DPOST12345/",10 "snippet": "Quick breakfast ideas from public Instagram posts.",11 "shortcode": "DPOST12345",12 "username": null,13 "post": {14 "id": "3654019287123456001",15 "shortcode": "DPOST12345",16 "taken_at": 1743235200,17 "media_type": "image",18 "product_type": "feed",19 "width": 1080,20 "height": 1350,21 "like_count": 820,22 "comment_count": 46,23 "caption": "Healthy breakfast ideas for busy mornings",24 "has_audio": false,25 "display_url": "https://instagram.example.com/post-display.jpg",26 "video_url": null,27 "thumbnail_url": "https://instagram.example.com/post-thumb.jpg",28 "owner": {29 "id": "25025320",30 "username": "breakfastlab",31 "full_name": "Breakfast Lab",32 "profile_pic_url": "https://instagram.example.com/profile.jpg",33 "is_verified": false34 },35 "audio_info": null,36 "carousel_media": null37 }38 }39 ],40 "pagination": {41 "nextCursor": "eyJuZXh0UGFyYW1zIjp7InM...",42 "hasMore": true43 },44 "timing": { "total": 1480 },45 "creditsUsed": 1,46 "creditsRemaining": 9947 }48}