> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 vi

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.

<Note>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.</Note>

## 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.                                                                                                              |

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

## Example

```bash theme={null}
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.

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