Facebook profile posts

Posts from a public Facebook profile or page feed, with message text, permalink, timestamp, per-type reaction breakdown, comment and share counts, images and video files. Also resolves profile details and profile IDs.

Use to pull a public profile’s or page’s recent feed, or to resolve a profile URL to its numeric ID. Public targets only. Pick an endpoint first, then fill the matching text field: urls_text for the by-URL endpoints, ids_text for the by-ID endpoints, keywords_text for keyword search.

Price

$0.0180 per result. That is the rate you pay for each result the call returns, so the total depends on how many it produces. Billing follows actual usage, so a call that returns fewer results costs less. discover and inspect also return a ceiling for your specific request, which is a maximum you will never be charged above.

Input

Field	Type	Required	Notes
`end_date`	`string`		Optional YYYY-MM-DD upper bound for post and keyword endpoints.
`endpoint`	`profile_posts_by_url`, `profile_posts`, `search_posts_by_keyword`, `details_by_id`, `details_by_url`, `profile_id_by_url`	yes	What to fetch. profile_posts_by_url and profile_posts return feeds, details_* return profile metadata, profile_id_by_url resolves a URL to an ID.
`ids_text`	`string`		Newline-separated numeric profile IDs. Used by profile_posts and details_by_id.
`max_posts`	`integer`		Maximum posts per target. 0 means no limit. Every returned row is billed, and the by-URL endpoints also emit one extra billed row per target that carries the resolved profile ID.
`urls_text`	`string`		Newline-separated profile or page URLs. Used by profile_posts_by_url, details_by_url and profile_id_by_url. Note this is a STRING with one URL per line, not an array.
`start_date`	`string`		Optional YYYY-MM-DD lower bound for post and keyword endpoints.
`keywords_text`	`string`		Newline-separated search queries. Used by search_posts_by_keyword.

Goro forwards your input to the underlying tool unchanged, so any field the tool accepts works here even if it is not listed above.

Example

curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"facebook.profile_posts","input":{"endpoint":"profile_posts_by_url","max_posts":3}}'

Response

One row of the response. Values are illustrative.

{
  "profile_id": "sample-id-000",
  "url (search term)": "https://facebook.com/example-account/100063663337621/"
}

Guide

CLI reference

API reference

Tools

Facebook profile posts

Price

Input

Example

Response

​Price

​Input

​Example

​Response

Price

Input

Example

Response