Instagram

Instagram User posts API

Q: Do I need a Instagram account or API key?

No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Instagram login or developer app is needed.

Q: How do I get more results?

Each response includes a cursor. Send it back as the cursor parameter with the same other parameters to get the next page. It is null on the last page.

To get a profile's posts and Reels from Instagram, call GET /v1/instagram/user/posts?handle=… with your API key. You get clean JSON back.

GET/v1/instagram/user/posts

curl "https://api.scraperize.com/v1/instagram/user/posts?handle=natgeo" \
  -H "x-api-key: YOUR_API_KEY"

Cost

1 credit / call

Only successful calls are charged. Errors are free.

Pagination

Cursor

Pass the returned cursor to get the next page.

Caching

0 credits

Set cache_max_age to reuse a recent result for free.

Rate limit

Per team / minute

Over the limit: 429 with a Retry-After header.

Parameters

handleRequired

The Instagram username, e.g. natgeo (an @handle or profile URL also works).

cursorOptional

The cursor from a previous response (same handle) to fetch the next page. Omit for the first page.

cache_max_ageOptional

Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.One of 5 values.

Send your key in the x-api-key header. Full API reference

Example response

200 OK · application/json

{
  "data": {
    "user": {
      "id": "787132",
      "handle": "natgeo",
      "fullName": "National Geographic",
      "isVerified": true,
      "profilePicUrl": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x…",
      "url": "https://www.instagram.com/natgeo/",
      "profilePicUrlHd": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?_nc_cat=1&ccb=7-5…",
      "isPrivate": false
    },
    "posts": [
      {
        "id": "3983118388705688735",
        "code": "DdG4RIxIPyf",
        "url": "https://www.instagram.com/reel/DdG4RIxIPyf/",
        "postType": "video",
        "productType": "clips",
        "isReel": true,
        "owner": {
          "id": "787132",
          "handle": "natgeo",
          "fullName": "National Geographic",
          "isVerified": true,
          "profilePicUrl": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x…",
          "url": "https://www.instagram.com/natgeo/"
        },
        "caption": "Presented by @Rolex. Welcome to Africa 🌍 Africa Earth’s Wild Home takes you deep into the heart of our wildest continen…",
        "captionIsEdited": false,
        "hashtags": [
          "Rolex",
          "PerpetualPlanet"
        ],
        "mentions": [
          "Rolex",
          "wunmimosaku",
          "DisneyPlus"
        ],
        "takenAt": "2026-09-10T13:00:14.000Z",
        "likeCount": 79118,
        "commentCount": 557,
        "likeAndViewCountsHidden": false,
        "isPinned": true,
        "isPaidPartnership": true,
        "width": 1080,
        "height": 1920,
        "imageUrl": "https://instagram.fmad26-1.fna.fbcdn.net/v/t51.82787-15/802503979_18695767555019133_6909214034622416488_n.jpg?stp=dst-jp…",
        "videoUrl": "https://instagram.fmad26-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQPDJtVww4K_686Ed9TbciE3dp0nrA4iUd5M8OJJIZKcU-RmkzTGwtpi3CsZY9Pg…",
        "videoVersions": [
          {
            "type": 101,
            "url": "https://instagram.fmad26-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQPDJtVww4K_686Ed9TbciE3dp0nrA4iUd5M8OJJIZKcU-RmkzTGwtpi3CsZY9Pg…",
            "width": 720,
            "height": 1280
          }
        ],
        "videoDurationSeconds": 72.614,
        "hasAudio": true,
        "thumbnailUrl": "https://scontent.cdninstagram.com/v/t51.82787-15/802503979_18695767555019133_6909214034622416488_n.jpg?stp=c0.420.1080.1…",
        "accessibilityCaption": null,
        "aiLabel": null,
        "location": null,
        "audio": {
          "type": "original_sounds",
          "id": "26106058285758518",
          "title": "Original audio",
          "artist": "natgeo",
          "artistHandle": "natgeo",
          "coverUrl": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x…",
          "isExplicit": false,
          "isTrending": false
        },
        "coauthors": [
          {
            "id": "1165531538",
            "handle": "rolex",
            "fullName": "ROLEX",
            "isVerified": true,
            "profilePicUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/12142450_157279231293241_2115688096_a.jpg?stp=dst-jpg_s150x150_tt6&_nc_c…",
            "url": "https://www.instagram.com/rolex/"
          }
        ],
        "sponsors": [
          {
            "id": "1165531538",
            "handle": "rolex",
            "fullName": "ROLEX",
            "isVerified": null,
            "profilePicUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/12142450_157279231293241_2115688096_a.jpg?stp=dst-jpg_s150x150_tt6&_nc_c…",
            "url": "https://www.instagram.com/rolex/"
          }
        ],
        "taggedUsers": [
          {
            "id": "1165531538",
            "handle": "rolex",
            "fullName": "ROLEX",
            "isVerified": true,
            "profilePicUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/12142450_157279231293241_2115688096_a.jpg?stp=dst-jpg_s150x150_tt6&_nc_c…",
            "url": "https://www.instagram.com/rolex/",
            "x": 0,
            "y": 0
          }
        ],
        "carouselCount": null,
        "carouselItems": []
      }
    ],
    "count": 12,
    "cursor": "eyJoIjoibmF0Z2VvIiwiYyI6IkFRSFRTQVFmd0llQ2s0QkdnNDFvVzFDQmNOVmpKR2d6eXNodklTSWkyZlVCNlJmbWhodC1Gb3pxSVpUWm0tNWJKNDJXUWs0…",
    "hasMore": true,
    "fetchedAt": "2026-10-09T12:23:01.218Z"
  },
  "meta": {
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
    "creditsCharged": 1,
    "creditsRemaining": 4999,
    "cached": false
  }
}

A real response, shortened to one item per list.

More Instagram endpoints

Profile Basic profile User Reels Profile post count Post

FAQ

Instagram User posts API questions

How much does the Instagram User posts API cost?

1 credit per successful call. Errors and cached results are free, and new accounts start with 100 free credits, no card required. See pricing.

Do I need a Instagram account or API key?

No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Instagram login or developer app is needed.

How fresh is the data?

Each call fetches the data live. To trade freshness for cost, pass cache_max_age (e.g. 1h, 1d) to get a recent cached result instantly for 0 credits.

How do I get more results?

Each response includes a cursor. Send it back as the cursor parameter with the same other parameters to get the next page. It is null on the last page.

Where are the full parameters and response fields?

In the API reference, with every parameter, field and error.

Try the Instagram User posts API

Grab your key and 100 free credits, no card required, and run this call in minutes.