Instagram Post Lookup (by Profile or Post URL)

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "array",
      "description": "Insert the username or URL of any profile you want to get posts from. You can also paste the post URLs."
    },
    "resultsLimit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "description": "This is the maximum number of posts you want to scrape per profile. If you set it to 5, you'll get 5 posts for each profile you've included. This setting does not apply if you're scraping by post URLs."
    },
    "dataDetailLevel": {
      "enum": [
        "basicData",
        "detailedData"
      ],
      "type": "string",
      "default": "detailedData",
      "enumTitles": [
        "Basic data",
        "Detailed data"
      ],
      "description": "Choose the data package you want to extract. Please note the Detailed data are paid extra.",
      "sectionCaption": "🔍 How detailed do you want the data?",
      "sectionDescription": "In this section, you can pick the version of the data you want to scrape. `Basic data` is faster and cheaper. `Detailed data` adds fields like alt text, latest comments, music info, paid partnership, and video play count. Please note that this is a paid add-on."
    },
    "skipPinnedPosts": {
      "type": "boolean",
      "default": false,
      "description": "Check if you do not want to save pinned posts."
    },
    "onlyPostsNewerThan": {
      "type": "string",
      "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
      "dateType": "absoluteOrRelative",
      "description": "Limit how far back to the history the scraper should go. The date should be in YYYY-MM-DD or full ISO absolute format or in relative format e.g. 1 days, 2 months, 3 years. All time values are taken in UTC timezone"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "shortCode"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The post's own Instagram media id."
          },
          "type": {
            "type": "string",
            "description": "Observed 'Image', 'Video', and 'Sidecar' (multi-photo/video carousel)."
          },
          "caption": {
            "type": [
              "string",
              "null"
            ],
            "description": "The post's caption text."
          },
          "hashtags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Hashtags parsed from the caption; an empty array when none are used. At least one real observed value carried a trailing comma from the original caption text ('NatGeoLION,') -- the upstream provider does not clean this, so a caller matching against a hashtag should not assume it is always a bare word."
          },
          "isPinned": {
            "type": "boolean",
            "description": "Present only when the post is one of the profile's pinned posts; ABSENT entirely (not `false`) on a post fetched directly by URL and on any non-pinned post -- confirmed: absent from 3 of 5 posts in the username-lookup fixture and from the whole post-URL fixture."
          },
          "shortCode": {
            "type": "string",
            "description": "The post's short code, e.g. 'DLNsnpUTdVS'. Combine with 'https://www.instagram.com/p/' to build the post's public permalink."
          },
          "timestamp": {
            "type": "string",
            "description": "ISO 8601 publish time."
          },
          "likesCount": {
            "type": "integer",
            "minimum": 0
          },
          "productType": {
            "type": "string",
            "description": "Instagram's own internal post-format label (observed 'clips', 'feed'). Absent entirely on at least one real Sidecar (carousel) post -- confirmed against a real fixture, not assumed always present."
          },
          "commentsCount": {
            "type": "integer",
            "minimum": 0
          },
          "ownerFullName": {
            "type": "string",
            "description": "The posting account's own display name."
          },
          "ownerUsername": {
            "type": "string",
            "description": "The posting account's own username."
          },
          "dimensionsWidth": {
            "type": "integer",
            "minimum": 0
          },
          "dimensionsHeight": {
            "type": "integer",
            "minimum": 0
          },
          "coauthorProducers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "username": {
                  "type": "string",
                  "description": "The collaborating account's own username."
                },
                "is_verified": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            },
            "description": "Other Instagram accounts tagged as collaborators on this post (Instagram's 'collab post' feature). ABSENT entirely (not an empty array) on a post with no collaborators -- confirmed: absent from 3 of 5 posts in the username-lookup fixture and from the whole post-URL fixture."
          },
          "isCommentsDisabled": {
            "type": "boolean"
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per matching post -- up to resultsLimit for a username/profile lookup, or exactly one per post URL supplied."
    }
  },
  "description": "Matching posts, wrapped in an object because a run's output is always a JSON object -- the provider's own response is a bare array. Up to resultsLimit entries for a username/profile lookup, or exactly one per post URL supplied. Each entry is one billed result (one post).",
  "additionalProperties": false
}