# Instagram Profile API Reference Canonical: https://monsterapi.co/docs/api/instagram-profile Read the Instagram Profile reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [Instagram](https://monsterapi.co/docs/openapi/platforms/instagram.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # Instagram: Profile by ID `GET /instagram/api/profile/id/{id}` Documentation: https://monsterapi.co/docs/api/instagram#profile-by-id Operation ID: `instagram_profile_read_by_id` Returns profile details for an account ID, including its current username. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Account ID, 1 to 32 decimal digits. Copy `user.id` from GET `/profile/{username}`. [Profile reference](https://monsterapi.co/docs/api/instagram-profile). ## Responses - 200: - 400: Refusal envelope. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope. Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope. Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope. Refused at the gateway: the API key is unknown or revoked - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope. Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope. Refused at the gateway: the account calls faster than its rate limit allows - 503: Temporary unavailability or a rate limit. Retry-After is included when applicable. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope. ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/instagram/api/profile/id/{id}' \ -H 'Authorization: Bearer ' ``` --- # Instagram: Profile counts and first media `GET /instagram/api/profile/info/{username}` Documentation: https://monsterapi.co/docs/api/instagram#profile-counts-and-first-media Operation ID: `instagram_profile_info_read` Returns profile counts, category and available first posts and videos for a username. upstream_error (503) or upstream_shape (500) does not establish whether the account exists. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `username` (path, required): Account username without @, 1 to 64 letters, digits, dots, underscores or hyphens. A username may also be copied from `user.username` in GET `/profile/id/{id}`. [Profile reference](https://monsterapi.co/docs/api/instagram-profile). ## Responses - 200: - 400: Refusal envelope. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope. Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope. Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope. Refused at the gateway: the API key is unknown or revoked - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope. Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope. Refused at the gateway: the account calls faster than its rate limit allows - 503: Temporary unavailability or a rate limit. Retry-After is included when applicable. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope. ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/instagram/api/profile/info/{username}' \ -H 'Authorization: Bearer ' ``` --- # Instagram: Profile and highlights `GET /instagram/api/profile/{username}` Documentation: https://monsterapi.co/docs/api/instagram#profile-and-highlights Operation ID: `instagram_profile_read` Returns a profile and its available highlights for an account username. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `username` (path, required): Account username without @, 1 to 64 letters, digits, dots, underscores or hyphens. A username may also be copied from `user.username` in GET `/profile/id/{id}`. [Profile reference](https://monsterapi.co/docs/api/instagram-profile). ## Responses - 200: - 400: Refusal envelope. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope. Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope. Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope. Refused at the gateway: the API key is unknown or revoked - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope. Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope. Refused at the gateway: the account calls faster than its rate limit allows - 503: Temporary unavailability or a rate limit. Retry-After is included when applicable. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope. ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/instagram/api/profile/{username}' \ -H 'Authorization: Bearer ' ``` --- # Instagram: Suggested accounts `GET /instagram/api/user/{id}/similar` Documentation: https://monsterapi.co/docs/api/instagram#suggested-accounts Operation ID: `instagram_user_similar_list` Returns accounts suggested for an account. An empty list returns not_found (404) and does not distinguish private, unavailable or empty accounts. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Account ID, 1 to 32 decimal digits. Copy `user.id` from GET `/profile/{username}`; the ID remains stable across username changes. [Profile reference](https://monsterapi.co/docs/api/instagram-profile). ## Responses - 200: - 400: Refusal envelope. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope. Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope. Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope. Refused at the gateway: the API key is unknown or revoked - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope. Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope. Refused at the gateway: the account calls faster than its rate limit allows - 503: Temporary unavailability or a rate limit. Retry-After is included when applicable. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope. ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/instagram/api/user/{id}/similar' \ -H 'Authorization: Bearer ' ```