Tools

⌄

Instagram tools

Seven tools implemented; live verification pending. Search uses Google-indexed posts.

7 tools are implemented in this family. The definitions below come from the service’s actual tool catalog.

This family includes implemented tools with provider or platform limitations. Live provider verification is pending; read each description before using it.

Authenticate, inspect the schema, then request an estimate using dry_run where supported. Research can spend workspace credits.

Get an Instagram account

instagram_get_profile

Public profile and available contact details.

REST endpoint

POST /api/social/tools/instagram_get_profile

Product-credit cost

5 product credits per call/page. No fixed number of rows per page. Use dry_run for the selected options' quote.

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "maxLength": 65,
      "pattern": "^@?[A-Za-z0-9._]+$"
    },
    "dry_run": {
      "default": false,
      "type": "boolean"
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,100}$"
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false
}

Get Instagram posts

instagram_get_posts

One page of public account posts. Page size varies.

REST endpoint

POST /api/social/tools/instagram_get_posts

Product-credit cost

5 product credits per call/page. No fixed number of rows per page. Use dry_run for the selected options' quote.

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "maxLength": 65,
      "pattern": "^@?[A-Za-z0-9._]+$"
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384
    },
    "dry_run": {
      "default": false,
      "type": "boolean"
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,100}$"
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false
}

Get Instagram reels

instagram_get_reels

One page of public reels. Captions and pinned reels are omitted by this provider.

REST endpoint

POST /api/social/tools/instagram_get_reels

Product-credit cost

5 product credits per call/page. No fixed number of rows per page. Use dry_run for the selected options' quote.

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "maxLength": 65,
      "pattern": "^@?[A-Za-z0-9._]+$"
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384
    },
    "dry_run": {
      "default": false,
      "type": "boolean"
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,100}$"
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false
}

Get an Instagram post

instagram_get_post

One post or reel by URL. Media downloading is disabled.

REST endpoint

POST /api/social/tools/instagram_get_post

Product-credit cost

5 product credits per call/page. No fixed number of rows per page. Use dry_run for the selected options' quote.

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "dry_run": {
      "default": false,
      "type": "boolean"
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,100}$"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Get Instagram comments

instagram_get_comments

One page of comments. include_replies is optional and costs more; results may be partial.

REST endpoint

POST /api/social/tools/instagram_get_comments

Product-credit cost

5 product credits per call/page; 75 with include_replies. No fixed number of rows per page. Use dry_run for the selected options' quote.

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "include_replies": {
      "default": false,
      "type": "boolean"
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384
    },
    "dry_run": {
      "default": false,
      "type": "boolean"
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,100}$"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Search Instagram hashtags

instagram_search_posts

One page of Google-indexed public posts for a hashtag; differs from native Instagram-ranked search.

REST endpoint

POST /api/social/tools/instagram_search_posts

Product-credit cost

5 product credits per call/page. No fixed number of rows per page. Use dry_run for the selected options' quote.

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "since": {
      "default": "month",
      "type": "string",
      "enum": [
        "day",
        "week",
        "month",
        "year",
        "all"
      ]
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384
    },
    "dry_run": {
      "default": false,
      "type": "boolean"
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,100}$"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Get an Instagram transcript

instagram_get_transcript

AI transcript of a video up to two minutes. Long paid transcription is disabled.

REST endpoint

POST /api/social/tools/instagram_get_transcript

Product-credit cost

5 product credits per call/page. No fixed number of rows per page. Use dry_run for the selected options' quote.

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "dry_run": {
      "default": false,
      "type": "boolean"
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,100}$"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}