SocketStore

API Documentation

Introduction

SocketStore allows your application to retrieve data about Instagram profiles and their Reels. All API requests must be made via HTTPS and include your API key in the header.

Base URL

https://socket-app-jb.store/api

Authentication

To access the API, you need to include the API key in the X-API-Key header of each request. You can get a key after registration and account activation. 

X-API-Key: your_api_key

Response Formats

All API responses are returned in JSON format. In case of an error, the API will return the corresponding HTTP code and a JSON object with an error description.

Want to get started?

Create an account and get an API key to integrate with SocketStore.

Register

API Endpoints

POST /api/instagram/profile

Get information about an Instagram profile from a URL.

Request Parameters

Parameter Type Description
instagram_url string Instagram profile URL (e.g., https://instagram.com/username/)

Request Example

curl -X POST \
  https://socket-app-jb.store/api/instagram/profile \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your_api_key' \
  -d '{
    "instagram_url": "https://www.instagram.com/instagram/"
  }'

Response Example

{
  "username": "instagram",
  "full_name": "Instagram",
  "follower_count": 618000000,
  "following_count": 76,
  "media_count": 7462,
  "is_private": false,
  "biography": "Bringing you closer to the people and things you love. ❤️",
  "profile_pic_url": "https://scontent-ort2-1.cdninstagram.com/v/t51.2885-19/s150x150/119380116_171702954602652_9082591470749777498_n.jpg?_nc_ht=scontent-ort2-1.cdninstagram.com&_nc_ohc=WRYLc1p3OlMAX8VZgl8&oh=5b8d3b6b6d260950992f0291c9a13890&oe=5F93511F",
  "user_id": "25025320"
}
POST /api/instagram/reel

Get information about a specific Reel by URL.

Request Parameters

Parameter Type Description
instagram_url string Reel URL (e.g., https://instagram.com/reel/ABC123/)

Request Example

curl -X POST \
  https://socket-app-jb.store/api/instagram/reel \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your_api_key' \
  -d '{
    "instagram_url": "https://www.instagram.com/reel/CuXoLG2Ow2G/"
  }'

Response Example

{
  "id": "3142269584673722234",
  "code": "CuXoLG2Ow2G",
  "permalink": "https://www.instagram.com/reel/CuXoLG2Ow2G/",
  "caption": "How to make your brand pop in a crowded market 🚀 #instagram #reels #digitalmarketing",
  "view_count": 1457843,
  "like_count": 129873,
  "comment_count": 873,
  "share_count": 2341,
  "created_at": "2023-06-28T14:23:17"
}
POST /api/instagram/reels

Get multiple recent Reels of a user from the profile URL.

Request Parameters

Parameter Type Description Required
instagram_url string Instagram profile URL (e.g., https://instagram.com/username/) Yes
count integer Number of Reels to fetch (1 to 30) No (default 12)

Request Example

curl -X POST \
  https://socket-app-jb.store/api/instagram/reels \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your_api_key' \
  -d '{
    "instagram_url": "https://www.instagram.com/instagram/",
    "count": 5
  }'

Response Example

{
  "reels": [
    {
      "id": "3142269584673722234",
      "code": "CuXoLG2Ow2G",
      "permalink": "https://www.instagram.com/reel/CuXoLG2Ow2G/",
      "caption": "How to make your brand pop in a crowded market 🚀 #instagram #reels #digitalmarketing",
      "view_count": 1457843,
      "like_count": 129873,
      "comment_count": 873,
      "share_count": 2341,
      "created_at": "2023-06-28T14:23:17"
    },
    {
      "id": "3141847562973845623",
      "code": "CuVzKhIO_w7",
      "permalink": "https://www.instagram.com/reel/CuVzKhIO_w7/",
      "caption": "New features coming soon! 📱✨ #instagramupdate",
      "view_count": 2345873,
      "like_count": 245698,
      "comment_count": 3241,
      "share_count": 5432,
      "created_at": "2023-06-27T10:15:32"
    },
    /* ... 3 more Reels ... */
  ],
  "has_more": true,
  "total_count": 5
}

Error Codes

Code Description
400 Invalid request. Check the provided parameters.
401 Authentication error. Check your API key.
402 Payment required. Your subscription has expired.
403 Access denied. You may have reached the account limit for your plan.
404 Resource not found. The account or reel doesn't exist or is unavailable.
429 Too many requests. You have exceeded the API request limit.
500 Internal server error. Try again later.

Need help?

If you're having trouble using the API or have questions not covered in the documentation, please contact our support team.

Contact support