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_profilePublic page details, contact information and available ad-library identity.
REST endpoint
POST /api/social/tools/facebook_get_profileProduct-credit cost
1 product credit 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,
"description": "Public account slug of 1 to 100 Unicode letters or numbers, periods, underscores or hyphens, optionally prefixed with @. Do not provide a URL."
},
"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_postsOne page of public posts. The supplier limits listings to three posts per page.
REST endpoint
POST /api/social/tools/facebook_get_postsProduct-credit cost
1 product credit 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,
"description": "Public account slug of 1 to 100 Unicode letters or numbers, periods, underscores or hyphens, optionally prefixed with @. Do not provide a URL."
},
"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_postRead 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_postProduct-credit cost
1 product credit 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_commentsOne page of public comments. Separate reply continuations are not fetched automatically.
REST endpoint
POST /api/social/tools/facebook_get_commentsProduct-credit cost
1 product credit 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_postsOne chronological page of accessible public group posts, up to three rows.
REST endpoint
POST /api/social/tools/facebook_get_group_postsProduct-credit cost
1 product credit 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_transcriptNative captions or provider AI transcription up to two minutes. Paid long transcription is disabled.
REST endpoint
POST /api/social/tools/facebook_get_transcriptProduct-credit cost
1 product credit 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
}