JustSERPDocs
Instagram

Instagram Profile

A public Instagram profile and its newest 12 posts, read as a visitor with no account and answered as the document: `profile` and `posts`.

GET
/v1/instagram/profile

A public Instagram profile and its newest 12 posts, read as a visitor with no account and answered as the document: profile and posts. What a logged-out page does not hold: posts[].likes and comments are null, iso_date is the day in the post's accessibility caption, profile.posts is the page's rounded figure (exact below 1,000), is_business is null; there is no next page. A private account has is_private: true and no posts. Addresses are Instagram's signed CDN addresses and expire: search again for fresh ones. An account that does not exist is 404 profile_not_found (after two sightings). zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
username*string

The account: natgeo, @natgeo or https://www.instagram.com/natgeo/ (lowercased). Not an Instagram username or profile address is 400.

Response Body

The profile, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The first keys of a document-form answer. Unlike DocumentHead there is no search_information unless the engine has one (there is none for the AI engines, Events, Events Details, Facebook, Tripadvisor Place, Trending Now and the Apple engines' places).

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
profile?
posts?array<>

The newest 12.

Example Request
curl -X GET 'https://api.justserp.com/v1/instagram/profile?username=natgeo'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "profile": {    "username": "string",    "name": "string",    "bio": "string",    "avatar": "string",    "avatar_hd": "string",    "is_verified": true,    "is_business": true,    "is_private": true,    "posts": 0,    "followers": 0,    "following": 0,    "external_link": "string",    "bio_links": [      {        "title": "string",        "url": "string"      }    ]  },  "posts": [    {      "position": 0,      "id": "string",      "permalink": "string",      "type": "image",      "carousel_count": 0,      "link": "string",      "thumbnail": "string",      "caption": "string",      "accessibility_caption": "string",      "likes": 0,      "comments": 0,      "iso_date": "string",      "date_precision": "string"    }  ]}

Zillow Property GET

One Zillow home, or apartment building, answered as the document: `search_metadata`, `search_parameters`, `search_information`, `property`, `attribution`, `mortgage_rates` and `nearby_schools`.

Instagram Post GET

One public Instagram post, reel or carousel, read as a visitor with no account and answered as the document with `post`: counts, time, every carousel item with its pictures and video files, tags, topics and the page's first 15 comments (`preview_comments`; `has_more_comments` says there are more, and `instagram_comments` pages them).