Skip to content

Discover posts by hashtag

The search functionality is available indirectly, as the scraper retrieves data by combining results from Google search. Because of this, results may differ slightly from what logged-in Instagram users see. The endpoint returns essential post metadata, including engagement metrics, and media URLs.

Base URL

POST https://instagram-scraper-api.datashake.com/v1/search

Request payload

callback_url

Field type: string
Required: true
Description: A URL to receive API results via a JSON POST request.

keyword

Field type: string
Required: true
Description: Keyword or hashtag that will be used to run the search.

external_identifier

Field type: string
Required: false
Description: A custom identifier for tracking your request. This value will be included in the callback payload.

Code example
curl --location 'https://instagram-scraper-api.datashake.com/v1/search' --header 'x-api-key: your-api-key' --header 'Content-Type: application/json' --request POST --data '{"keyword": "lululemon", "callback_url": "https://example.com/callback", "external_identifier": "my-custom-id"}'
import requests

url = "https://instagram-scraper-api.datashake.com/v1/search"

payload = {
    "keyword": "lululemon",
    "callback_url": "https://example.com/callback",
    "external_identifier": "my-custom-id"
}
headers = {
    "x-api-key": "your-api-key",
}

response = requests.post(url=url, headers=headers, json=payload)

Response and callback payload

API response example
{
    "status": "created",
    "message": "Your request was successfully submitted.",
    "request_id": "1742515679047322765-7538bd54-2bd7-45"
}
Callback payload example
{
    "request_id": "1742515679047322765-7538bd54-2bd7-45",
    "status": "completed",
    "credits_used": 130,
    "request_metadata": {
        "keyword": "lululemon",
        "callback_url": "http://example.com/callback",
        "external_identifier": "my-custom-id"
    },
    "results": [
        {
            "unique_id": "2566506032519125749",
            "post_id": "COeD6N-Mxr1",
            "description": "I am learning to love the Kettlebell! \nHere are the 3 moves I used to prepare my body for my usual Front, Back and Bulgarian Split Squat in today’s Leg Day. \n\nVideo # 1: KB Clean, Curtsy, Cossack,  Combo\nVideo # 2: KB Clean, Over head, Suitcase Split Squat. (I demonstrate a close stance with 80% of my weight loaded into my front leg)\nVideo # 3: Banded KB Sumo Deadlift \n_____________________________________\n#legday #kettlebellworkout #compoundexercises #lululemonleggings #itsagreatdaytohaveagreatday #putintheworkgettheresults #byronfuleffect",
            "hashtags": [
                "legday",
                "lululemonleggings",
                "lululemon",
                ...
            ],
            "url": "https://www.instagram.com/p/COeD6N-Mxr1/",
            "comments_count": 33,
            "likes_count": 4095,
            "view_count": null,
            "play_count": null,
            "upload_date": "2025-03-15",
            "author": {
                "username": "byronful",
                "name": "Byron Fulkerth",
                "id": "242832279",
                "profile_picture_url": null
            },
            "media": [
                {
                    "type": "image",
                    "thumbnail_url": "https://scontent-vie1-1.cdninstagram.com/v/t51.29350-15/181216866_307128057636691_3232999712835561252_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjE0NDB4MTc5OS5zZHIuZjI5MzUwLmRlZmF1bHRfaW1hZ2UifQ&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QEagv9JnHcEH_CNrZl3L6EdSOdxwvBTdYoQ26RGsnC_xZ4HbvYt3wKkGCojcTnyrRY&_nc_ohc=_uSTMMhDv_AQ7kNvgE9FXDD&_nc_gid=qHo0vZ0HaRQLbU-vXpFSgQ&edm=AGyKU4gBAAAA&ccb=7-5&ig_cache_key=MjU2NjUwNjAyNzk0NzM1MjI0OA%3D%3D.3-ccb7-5&oh=00_AYFLcayUI6E-dlvdZ7YmEydXXCVLk8OhzIC3vGBldPXL0g&oe=67F1D8C4&_nc_sid=2011ad",
                    "url": "https://scontent-vie1-1.cdninstagram.com/v/t51.29350-15/181216866_307128057636691_3232999712835561252_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjE0NDB4MTc5OS5zZHIuZjI5MzUwLmRlZmF1bHRfaW1hZ2UifQ&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QEagv9JnHcEH_CNrZl3L6EdSOdxwvBTdYoQ26RGsnC_xZ4HbvYt3wKkGCojcTnyrRY&_nc_ohc=_uSTMMhDv_AQ7kNvgE9FXDD&_nc_gid=qHo0vZ0HaRQLbU-vXpFSgQ&edm=AGyKU4gBAAAA&ccb=7-5&ig_cache_key=MjU2NjUwNjAyNzk0NzM1MjI0OA%3D%3D.3-ccb7-5&oh=00_AYFLcayUI6E-dlvdZ7YmEydXXCVLk8OhzIC3vGBldPXL0g&oe=67F1D8C4&_nc_sid=2011ad",
                    "id": "2566506027947352248"
                },
                {
                    "type": "video",
                    "thumbnail_url": "https://scontent-vie1-1.cdninstagram.com/v/t51.29350-15/181328037_1204831633305233_3765710951561681279_n.jpg?stp=dst-jpg_e35_p360x360_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjEwODB4MTM1MC5zZHIuZjI5MzUwLmRlZmF1bHRfY292ZXJfZnJhbWUifQ&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2QEagv9JnHcEH_CNrZl3L6EdSOdxwvBTdYoQ26RGsnC_xZ4HbvYt3wKkGCojcTnyrRY&_nc_ohc=cqrGdb0SXtgQ7kNvgGW52h0&_nc_gid=qHo0vZ0HaRQLbU-vXpFSgQ&edm=AGyKU4gBAAAA&ccb=7-5&ig_cache_key=MjU2NjUwNTM0MTc1NzMxNjgwMA%3D%3D.3-ccb7-5&oh=00_AYGEUfLXkcsLbg5KJbOdt33aT1xpKgsgcafiGTQ7UMmkRQ&oe=67F1C294&_nc_sid=2011ad",
                    "url": "https://scontent-vie1-1.cdninstagram.com/o1/v/t16/f2/m84/AQPBdvGvh48F7hAlJGHAejfIbh3y6SishwBruSq7OJPKrDx1PGcpOVsssfDrYKiH6efWV4sb1TSxIhpxrZk6vTxjjT_9xkXPUuBypPg.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_ohc=jDvqGTraalAQ7kNvgFsszT3&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0FST1VTRUxfSVRFTS5DMy45NjAuZGFzaF9iYXNlbGluZV8xX3YxIiwieHB2X2Fzc2V0X2lkIjo4NDU3NDQ4NDcxOTUxMTUsImFzc2V0X2FnZV9kYXlzIjoxNDI3LCJ2aV91c2VjYXNlX2lkIjoxMDE0NiwiZHVyYXRpb25fcyI6NDgsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=8ce64d6a4a523168&_nc_vs=HBksFQIYTGlnX2JhY2tmaWxsX3RpbWVsaW5lX3ZvZC82RTQ5Qjg1RjU0QUE5ODk5NEZCODU1MDVFMjcxRjBBOF92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dCRWNaQmVtLUdZVjVHOEdBSzVJWXJuVm90SXhicGt3QUFBRhUCAsgBACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJtavgJPqzIADFQIoAkMzLBdASCZmZmZmZhgSZGFzaF9iYXNlbGluZV8xX3YxEQB17gcA&_nc_zt=28&oh=00_AYFbjnhGT62VLiLRBCtNc8Fg3L6yD_kV2PFSEWaKbq_7hw&oe=67EDC23D",
                    "id": "2566505341757316800",
                },
                ...
            ],
            "tagged_users": null,
            "created_at": "2025-03-21T00:08:07.793135Z",
            "updated_at": "2025-03-21T00:08:07.793136Z",
        },
        ...
    ],
    "summary": {
        "total_posts": 100,
        "unique_user_count": 98
    },
    "pagination": {
        "total": 100,
        "page": 1,
        "per_page": 50,
        "total_pages": 2
    }
}

Get search results

Use this endpoint to retrieve results in a synchronous manner.

Note that this endpoint is not intended for polling - make sure to check if your request has completed before calling it.

Base URL

GET https://instagram-scraper-api.datashake.com/v1/search/:request_id

Path parameters

request_id

Field type: string
Required: true
Description: The unique identifier for the request.

Request parameters

page

Field type: integer
Required: false
Description: The page number of the results to retrieve.

per_page

Field type: integer
Required: false
Description: The number of results to retrieve per page.

Code example
curl --location 'https://instagram-scraper-api.datashake.com/v1/search/1742515679047322765-7538bd54-2bd7-45?page=1&per_page=10' --header 'x-api-key: your-api-key'
import requests

url = "https://instagram-scraper-api.datashake.com/v1/search/1742515679047322765-7538bd54-2bd7-45"

params = {
    "page": 1,
    "per_page": 10
}
headers = {
    'x-api-key': 'your-api-key',
}

response = requests.get(url=url, headers=headers, params=params)

Response

API response example
{
    "request_id": "1742515679047322765-7538bd54-2bd7-45",
    "status": "completed",
    "credits_used": 130,
    "request_metadata": {
        "keyword": "lululemon",
        "callback_url": "http://example.com/callback",
        "external_identifier": "my-custom-id"
    },
    "results": [
        {
            "unique_id": "2566506032519125749",
            "post_id": "COeD6N-Mxr1",
            "description": "I am learning to love the Kettlebell! \nHere are the 3 moves I used to prepare my body for my usual Front, Back and Bulgarian Split Squat in today’s Leg Day. \n\nVideo # 1: KB Clean, Curtsy, Cossack,  Combo\nVideo # 2: KB Clean, Over head, Suitcase Split Squat. (I demonstrate a close stance with 80% of my weight loaded into my front leg)\nVideo # 3: Banded KB Sumo Deadlift \n_____________________________________\n#legday #kettlebellworkout #compoundexercises #lululemonleggings #itsagreatdaytohaveagreatday #putintheworkgettheresults #byronfuleffect",
            "hashtags": [
                "legday",
                "lululemonleggings",
                "lululemon",
                ...
            ],
            "url": "https://www.instagram.com/p/COeD6N-Mxr1/",
            "comments_count": 33,
            "likes_count": 4095,
            "view_count": null,
            "play_count": null,
            "upload_date": "2025-03-15",
            "author": {
                "username": "byronful",
                "name": "Byron Fulkerth",
                "id": "242832279",
                "profile_picture_url": null
            },
            "tagged_users": null,
            "media": [
                {
                    "type": "image",
                    "thumbnail_url": "https://scontent-vie1-1.cdninstagram.com/v/t51.29350-15/181216866_307128057636691_3232999712835561252_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjE0NDB4MTc5OS5zZHIuZjI5MzUwLmRlZmF1bHRfaW1hZ2UifQ&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QEagv9JnHcEH_CNrZl3L6EdSOdxwvBTdYoQ26RGsnC_xZ4HbvYt3wKkGCojcTnyrRY&_nc_ohc=_uSTMMhDv_AQ7kNvgE9FXDD&_nc_gid=qHo0vZ0HaRQLbU-vXpFSgQ&edm=AGyKU4gBAAAA&ccb=7-5&ig_cache_key=MjU2NjUwNjAyNzk0NzM1MjI0OA%3D%3D.3-ccb7-5&oh=00_AYFLcayUI6E-dlvdZ7YmEydXXCVLk8OhzIC3vGBldPXL0g&oe=67F1D8C4&_nc_sid=2011ad",
                    "url": "https://scontent-vie1-1.cdninstagram.com/v/t51.29350-15/181216866_307128057636691_3232999712835561252_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjE0NDB4MTc5OS5zZHIuZjI5MzUwLmRlZmF1bHRfaW1hZ2UifQ&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QEagv9JnHcEH_CNrZl3L6EdSOdxwvBTdYoQ26RGsnC_xZ4HbvYt3wKkGCojcTnyrRY&_nc_ohc=_uSTMMhDv_AQ7kNvgE9FXDD&_nc_gid=qHo0vZ0HaRQLbU-vXpFSgQ&edm=AGyKU4gBAAAA&ccb=7-5&ig_cache_key=MjU2NjUwNjAyNzk0NzM1MjI0OA%3D%3D.3-ccb7-5&oh=00_AYFLcayUI6E-dlvdZ7YmEydXXCVLk8OhzIC3vGBldPXL0g&oe=67F1D8C4&_nc_sid=2011ad",
                    "id": "2566506027947352248"
                },
                {
                    "type": "video",
                    "thumbnail_url": "https://scontent-vie1-1.cdninstagram.com/v/t51.29350-15/181328037_1204831633305233_3765710951561681279_n.jpg?stp=dst-jpg_e35_p360x360_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjEwODB4MTM1MC5zZHIuZjI5MzUwLmRlZmF1bHRfY292ZXJfZnJhbWUifQ&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2QEagv9JnHcEH_CNrZl3L6EdSOdxwvBTdYoQ26RGsnC_xZ4HbvYt3wKkGCojcTnyrRY&_nc_ohc=cqrGdb0SXtgQ7kNvgGW52h0&_nc_gid=qHo0vZ0HaRQLbU-vXpFSgQ&edm=AGyKU4gBAAAA&ccb=7-5&ig_cache_key=MjU2NjUwNTM0MTc1NzMxNjgwMA%3D%3D.3-ccb7-5&oh=00_AYGEUfLXkcsLbg5KJbOdt33aT1xpKgsgcafiGTQ7UMmkRQ&oe=67F1C294&_nc_sid=2011ad",
                    "url": "https://scontent-vie1-1.cdninstagram.com/o1/v/t16/f2/m84/AQPBdvGvh48F7hAlJGHAejfIbh3y6SishwBruSq7OJPKrDx1PGcpOVsssfDrYKiH6efWV4sb1TSxIhpxrZk6vTxjjT_9xkXPUuBypPg.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-vie1-1.cdninstagram.com&_nc_ohc=jDvqGTraalAQ7kNvgFsszT3&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0FST1VTRUxfSVRFTS5DMy45NjAuZGFzaF9iYXNlbGluZV8xX3YxIiwieHB2X2Fzc2V0X2lkIjo4NDU3NDQ4NDcxOTUxMTUsImFzc2V0X2FnZV9kYXlzIjoxNDI3LCJ2aV91c2VjYXNlX2lkIjoxMDE0NiwiZHVyYXRpb25fcyI6NDgsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=8ce64d6a4a523168&_nc_vs=HBksFQIYTGlnX2JhY2tmaWxsX3RpbWVsaW5lX3ZvZC82RTQ5Qjg1RjU0QUE5ODk5NEZCODU1MDVFMjcxRjBBOF92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dCRWNaQmVtLUdZVjVHOEdBSzVJWXJuVm90SXhicGt3QUFBRhUCAsgBACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJtavgJPqzIADFQIoAkMzLBdASCZmZmZmZhgSZGFzaF9iYXNlbGluZV8xX3YxEQB17gcA&_nc_zt=28&oh=00_AYFbjnhGT62VLiLRBCtNc8Fg3L6yD_kV2PFSEWaKbq_7hw&oe=67EDC23D",
                    "id": "2566505341757316800",
                },
                ...
            ],
            "created_at": "2025-03-21T00:08:07.793135Z",
            "updated_at": "2025-03-21T00:08:07.793136Z",
        },
        ...
    ],
    "summary": {
        "total_posts": 100,
        "unique_user_count": 98
    },
    "pagination": {
        "total": 100,
        "page": 1,
        "per_page": 50,
        "total_pages": 2
    }
}