Instagram

Instagram: users, posts, reels, stories, and comments.

Resolve user ID from handle

get

Returns whether the handle is available and, if it exists, the resolved Instagram user ID.

Cost: 50 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

handlestring · min: 1 · max: 100RequiredExample: instagram

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/userid/{handle}

GET /instagram/userid/{handle} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "isAvailable": true,
      "handle": "instagram",
      "id": "25025320"
    }
  ],
  "pricing": {
    "creditsCharged": 51
  }
}

Get a user by handle

get

Returns an Instagram user profile by handle (without @).

Cost: 100 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

handlestring · min: 1 · max: 100RequiredExample: instagram

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/user/handle/{handle}

GET /instagram/user/handle/{handle} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "user",
      "isAvailable": true,
      "id": "25025320",
      "username": "instagram",
      "fullName": "Instagram",
      "biography": "Discover what's new on Instagram 🔎✨",
      "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
      "website": "https://about.instagram.com",
      "category": "App page",
      "cityName": "text",
      "isPrivate": false,
      "isVerified": true,
      "isBusiness": true,
      "hasVideos": true,
      "hasGuides": false,
      "postCount": 8200,
      "followerCount": 689000000,
      "followingCount": 264,
      "totalReelsCount": 1850,
      "bioLinks": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pricing": {
    "creditsCharged": 101
  }
}

Get a user by ID

get

Returns an Instagram user profile by numeric user ID.

Cost: 100 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 25025320

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/user/{id}

GET /instagram/user/{id} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "user",
      "isAvailable": true,
      "id": "25025320",
      "username": "instagram",
      "fullName": "Instagram",
      "biography": "Discover what's new on Instagram 🔎✨",
      "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
      "website": "https://about.instagram.com",
      "category": "App page",
      "cityName": "text",
      "isPrivate": false,
      "isVerified": true,
      "isBusiness": true,
      "hasVideos": true,
      "hasGuides": false,
      "postCount": 8200,
      "followerCount": 689000000,
      "followingCount": 264,
      "totalReelsCount": 1850,
      "bioLinks": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pricing": {
    "creditsCharged": 101
  }
}

Get posts published by a user

get

Returns posts published by an Instagram user. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Cost: 50 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 25025320

Query parameters

maxItemsinteger · min: 1 · max: 200Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/user/{id}/posts

GET /instagram/user/{id}/posts HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "photo",
      "id": "3881985252256633854",
      "code": "CzABCdef123",
      "url": "https://www.instagram.com/p/CzABCdef123/",
      "caption": "Check out our latest update!",
      "createdAt": 1714560000,
      "likeCount": 12500,
      "commentCount": 320,
      "isAvailable": true,
      "isCarousel": false,
      "isVideo": false,
      "isPinned": false,
      "isPaidPartnership": false,
      "isLikeAndViewCountsDisabled": false,
      "owner": {
        "id": "25025320",
        "username": "instagram",
        "fullName": "Instagram",
        "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
        "isVerified": true,
        "isPrivate": false
      },
      "coowners": [
        {
          "id": "25025320",
          "username": "instagram",
          "fullName": "Instagram",
          "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
          "isVerified": true,
          "isPrivate": false
        }
      ],
      "location": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "image": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "audio": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "carouselMedia": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 51
  }
}

Get posts a user is tagged in

get

Returns posts where the Instagram user is tagged. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Cost: 150 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 25025320

Query parameters

maxItemsinteger · min: 1 · max: 200Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/user/{id}/posts/tagged

GET /instagram/user/{id}/posts/tagged HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "photo",
      "id": "3881985252256633854",
      "code": "CzABCdef123",
      "url": "https://www.instagram.com/p/CzABCdef123/",
      "caption": "Check out our latest update!",
      "createdAt": 1714560000,
      "likeCount": 12500,
      "commentCount": 320,
      "isAvailable": true,
      "isCarousel": false,
      "isVideo": false,
      "isPinned": false,
      "isPaidPartnership": false,
      "isLikeAndViewCountsDisabled": false,
      "owner": {
        "id": "25025320",
        "username": "instagram",
        "fullName": "Instagram",
        "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
        "isVerified": true,
        "isPrivate": false
      },
      "coowners": [
        {
          "id": "25025320",
          "username": "instagram",
          "fullName": "Instagram",
          "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
          "isVerified": true,
          "isPrivate": false
        }
      ],
      "location": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "image": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "audio": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "carouselMedia": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 151
  }
}

Get reels published by a user

get

Returns reels published by an Instagram user. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Cost: 50 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 25025320

Query parameters

maxItemsinteger · min: 1 · max: 200Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/user/{id}/reels

GET /instagram/user/{id}/reels HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "photo",
      "id": "3881985252256633854",
      "code": "CzABCdef123",
      "url": "https://www.instagram.com/p/CzABCdef123/",
      "caption": "Check out our latest update!",
      "createdAt": 1714560000,
      "likeCount": 12500,
      "commentCount": 320,
      "isAvailable": true,
      "isCarousel": false,
      "isVideo": false,
      "isPinned": false,
      "isPaidPartnership": false,
      "isLikeAndViewCountsDisabled": false,
      "owner": {
        "id": "25025320",
        "username": "instagram",
        "fullName": "Instagram",
        "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
        "isVerified": true,
        "isPrivate": false
      },
      "coowners": [
        {
          "id": "25025320",
          "username": "instagram",
          "fullName": "Instagram",
          "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
          "isVerified": true,
          "isPrivate": false
        }
      ],
      "location": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "image": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "audio": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "carouselMedia": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 51
  }
}

Get active stories for a user

get

Returns the user's currently-active Instagram stories (non-paginated).

Cost: 50 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 25025320

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/user/{id}/stories

GET /instagram/user/{id}/stories HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "photo",
      "id": "3245678901234567890",
      "code": "CzABCdef123",
      "createdAt": 1714560000,
      "expiringAt": 1714646400,
      "duration": 14.97,
      "hasAudio": true,
      "hasTranslation": false,
      "canReshare": true,
      "canReply": true,
      "isVideo": true,
      "owner": {
        "id": "25025320",
        "username": "instagram",
        "fullName": "Instagram",
        "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
        "isVerified": true,
        "isPrivate": false
      },
      "coowners": [
        {
          "id": "25025320",
          "username": "instagram",
          "fullName": "Instagram",
          "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
          "isVerified": true,
          "isPrivate": false
        }
      ],
      "image": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "audio": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "link": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "comments": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "mentions": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "hashtags": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pricing": {
    "creditsCharged": 51
  }
}

Get a post by shortcode

get

Returns a single Instagram post by its shortcode (the segment after /p/ in the URL).

Cost: 50 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

codestring · min: 1 · max: 100RequiredExample: CzABCdef123

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/post/code/{code}

GET /instagram/post/code/{code} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "photo",
      "id": "3881985252256633854",
      "code": "CzABCdef123",
      "url": "https://www.instagram.com/p/CzABCdef123/",
      "caption": "Check out our latest update!",
      "createdAt": 1714560000,
      "likeCount": 12500,
      "commentCount": 320,
      "isAvailable": true,
      "isCarousel": false,
      "isVideo": false,
      "isPinned": false,
      "isPaidPartnership": false,
      "isLikeAndViewCountsDisabled": false,
      "owner": {
        "id": "25025320",
        "username": "instagram",
        "fullName": "Instagram",
        "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
        "isVerified": true,
        "isPrivate": false
      },
      "coowners": [
        {
          "id": "25025320",
          "username": "instagram",
          "fullName": "Instagram",
          "profilePicUrl": "https://instagram.com/static/images/profile.jpg",
          "isVerified": true,
          "isPrivate": false
        }
      ],
      "location": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "image": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "video": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "audio": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "carouselMedia": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ],
  "pricing": {
    "creditsCharged": 51
  }
}

Get comments on a post

get

Returns comments on an Instagram post. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Cost: 75 credits/request + 1 credit/item

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · min: 1 · max: 100RequiredExample: 3890548995286221889

Query parameters

maxItemsinteger · min: 1 · max: 500Optional

cursorstringOptional

Responses

200

Successful request

application/json

requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24

statusintegerOptionalExample: 200

messagestringOptionalExample: OK

successbooleanOptionalExample: true

400

Bad request

application/json

402

Insufficient credits

application/json

404

Not found

application/json

get/instagram/post/{id}/comments

GET /instagram/post/{id}/comments HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "type": "comment",
      "id": "18470084392099954",
      "userId": "53847071613",
      "message": "Love this!",
      "createdAt": "2026-05-05T19:46:32.000Z",
      "likeCount": 27,
      "replyCount": 0,
      "isRanked": false,
      "user": {
        "id": "53847071613",
        "username": "someuser",
        "fullName": "Some User",
        "profilePicUrl": "text",
        "isPrivate": false,
        "isVerified": false,
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "creditsCharged": 76
  }
}