Tools

⌄

Facebook tools

Six public-page, post, group, comment and transcript tools implemented; live verification pending.

6 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 a Facebook page

facebook_get_profile

Public page details, contact information and available ad-library identity.

REST endpoint

POST /api/social/tools/facebook_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",
      "maxLength": 101,
      "pattern": "^@?[\\p{L}\\p{N}._-]{1,100}$"
    },
    "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}$"
    }
  },
  "additionalProperties": false
}

Get Facebook page posts

facebook_get_posts

One page of public posts. The supplier limits listings to three posts per page.

REST endpoint

POST /api/social/tools/facebook_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",
      "maxLength": 101,
      "pattern": "^@?[\\p{L}\\p{N}._-]{1,100}$"
    },
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "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}$"
    }
  },
  "additionalProperties": false
}

Get a Facebook post

facebook_get_post

Read one public post or reel, available engagement and shared-post references. Transcription is disabled on this tool.

REST endpoint

POST /api/social/tools/facebook_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 Facebook comments

facebook_get_comments

One page of public comments. Separate reply continuations are not fetched automatically.

REST endpoint

POST /api/social/tools/facebook_get_comments

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"
    },
    "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
}

Get Facebook group posts

facebook_get_group_posts

One chronological page of accessible public group posts, up to three rows.

REST endpoint

POST /api/social/tools/facebook_get_group_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": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "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
}

Get a Facebook transcript

facebook_get_transcript

Native captions or provider AI transcription up to two minutes. Paid long transcription is disabled.

REST endpoint

POST /api/social/tools/facebook_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
}