Skip to main content

​
Get Profile

Get detailed information about an Instagram profile.

​
Endpoint

GET /api/instagram/profile

​
Query Parameters

​
username
string
required
Instagram username

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/instagram/profile?username=cristiano" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/instagram/profile?username=cristiano', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'username': 'cristiano'}

response = requests.get(
    'https://rocks.rive.wtf/api/instagram/profile',
    headers=headers,
    params=params
)

print(response.json())

​
Response Example

{
  "data": {
    "user": {
      "username": "cristiano",
      "full_name": "Cristiano Ronaldo",
      "biography": "",
      "edge_followed_by": {
        "count": 670906725
      },
      "edge_follow": {
        "count": 626
      },
      "edge_owner_to_timeline_media": {
        "count": 4005,
        "edges": [
          {
            "node": {
              "id": "3820898462078635297",
              "display_url": "https://...",
              "edge_liked_by": {
                "count": 1360024
              },
              "edge_media_to_caption": {
                "edges": [
                  {
                    "node": {
                      "text": "Almost time ⏳"
                    }
                  }
                ]
              },
              "taken_at_timestamp": 1769706660,
              "is_video": false
            }
          }
        ]
      },
      "profile_pic_url": "https://...",
      "profile_pic_url_hd": "https://...",
      "is_verified": true,
      "is_private": false,
      "is_business_account": false,
      "external_url": "http://perplexity.ai/ronaldo"
    }
  }
}

​
Get Stories

Get active stories from an Instagram profile.

​
Endpoint

GET /api/instagram/stories

​
Query Parameters

​
username
string
required
Instagram username

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/instagram/stories?username=cristiano" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/instagram/stories?username=cristiano', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'username': 'cristiano'}

response = requests.get(
    'https://rocks.rive.wtf/api/instagram/stories',
    headers=headers,
    params=params
)

print(response.json())

​
Response Example

{
  "data": {
    "user": {
      "username": "cristiano",
      "edge_felix_video_timeline": {
        "count": 32,
        "edges": [
          {
            "node": {
              "id": "2873372485079719144",
              "display_url": "https://...",
              "is_video": true,
              "taken_at_timestamp": 1656752851,
              "edge_media_to_caption": {
                "edges": [
                  {
                    "node": {
                      "text": "Story caption here"
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    }
  }
}
Stories and reels data may be limited. The API returns available public content from the profile.