# Get an Instagram profile

### Get an Instagram profile

`GET /api/v1/instagram/profiles/{identity}`

Operation ID: `getInstagramProfile`

Returns a profile by username, with the connected account’s relationship to it. Counts against the daily profile view allowance. Returns 429 when the account is at its limit.

**Path parameters**

- `identity` (string, required): Username without @.

**Query parameters**

- `connectedAccountId` (string · uuid, required): Connected account to act as

**200**: Instagram profile.

- `profile` (object, required)
  - `username` (string | null, required)
  - `profileUrl` (string | null, required)
  - `firstName` (string | null, required): Split out of fullName, the one name a profile carries.
  - `lastName` (string | null, required)
  - `fullName` (string | null, required)
  - `biography` (string | null, required)
  - `category` (string | null, required): Business and creator accounts only.
  - `location` (string | null, required): City, on business accounts only.
  - `imageUrl` (string | null, required)
  - `imageUrlLarge` (string | null, required)
  - `backgroundImageUrl` (string | null, required)
  - `followerCount` (number | null, required)
  - `followingCount` (number | null, required)
  - `postCount` (number | null, required)
  - `mutualFollowerCount` (number | null, required): Followers shared with the connected account.
  - `externalLinks` (string[], required): Links in the biography.
  - `isPrivate` (boolean, required): True when only a follower can read the posts and followers.
  - `isVerified` (boolean, required)
  - `followRequestPending` (boolean, required): True while a follow request waits for an answer, which only a private account can do.
  - `isFollowing` (boolean, required): True when the connected account follows.
  - `isFollowedBy` (boolean, required): True when they follow the connected account.
- `remainingUsage` (object, required): Remaining allowance for this action on the connected account across hourly, daily, and weekly windows. Each action type has its own limits.
  - `hour` (integer | null, required): Remaining hourly allowance for this action. Null when this action has no hourly cap.
  - `day` (integer, required): Remaining daily allowance for this action.
  - `week` (integer | null, required): Remaining weekly allowance for this action. Null when this action has no weekly cap.
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload