ScrapeCreators: Facebook Post

Retrieves a single public Facebook post or reel by URL.

Tool ID: scrapecreators_facebook_post

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_facebook_post',
  {
    "url": "https://example.com"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute scrapecreators_facebook_post --input '{
  "url": "https://example.com"
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe scrapecreators_facebook_post --json for the complete live contract.

Input reference

Retrieves a single public Facebook post or reel by URL. Use one request per reel, passing its returned /reel/ URL from /v1/facebook/profile/reels, to retrieve available like_count, reaction_counts, comment_count, share_count, and a more precise view_count when Facebook exposes it. This endpoint accepts a single URL, not a batch. exact views are not guaranteed. Returns post_id, like_count, comment_count, share_count, view_count, description, creation_time, and author details, including the author handle when Facebook exposes a vanity profile URL. For some reels, Facebook does not expose the same view count on the individual post page that it shows on the profile Reels grid. This value can be null or lower than the public Reels badge. If you need the public Reel badge count, call /v1/facebook/profile/reels with the author URL and match the reel by post_id. For video posts, includes video See the live schema below for the complete notes.

Name	Type	Required	Default	Details
`payload.url`	`string`	Yes	—	The URL of the post to get
`payload.allow_long_transcription`	`boolean`	No	`false`	Paid opt-in, enabled only by the literal query value ‘true’ (allow_long_transcription=true). Defaults to false when omitted. other values do not enable paid mode. Over 120 seconds, videos cannot be AI-transcribed by default. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can See the live schema for the complete constraint.
`payload.get_transcript`	`boolean`	No	—	Transcription is opt-in via get_transcript=true. Over 120 seconds, videos cannot be AI-transcribed by default. Empty AI results and errors incur no AI fee. The base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.
`payload.cache_max_age`	`"1d" \| "3d" \| "7d" \| "14d" \| "30d"`	No	—	If we have a response in the cache that is this many days old or newer, return the cached response. Otherwise, scrape a live result. See the Caching page for details. Allowed: `1d`, `3d`, `7d`, `14d`, `30d`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`unknown`	Yes	—	Provider response payload.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: provider_usage (provider usage).
Estimated Deepline credits: 0.02 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation