Facebook: Search
facebook_searchSearch Facebook by keyword: pages, people, posts, videos and locations.
Actions:
action=pages: Find Facebook pages by keyword (brand, business or topic name), optionally near a location. Returns page names, URLs, categories and follower counts, 3 per call, plus an end_cursor. Use it when you don't have the page URL; then call facebook_page (action=details) with a result's URL. For locations, get a location_uid from action=locations. Pricing: 1 credit per call. Inputs: query (required), location_uid (optional), end_cursor (optional).
action=people: Find public Facebook profiles by name or keyword, optionally near a location (location_uid from action=locations). Returns names, profile URLs and pictures, plus work, education and location where public, and an end_cursor. Pricing: 1 credit per call. Inputs: query (required), location_uid (optional), end_cursor (optional).
action=posts: Search public Facebook posts by keyword, optionally filtered by location (location_uid from action=locations) and date range. Returns posts with text, author and engagement, plus an end_cursor. To list one page's posts, use facebook_page (action=posts) instead. Pricing: 1 credit per call. Inputs: query (required), location_uid (optional), start_time (optional), end_time (optional), recent_posts (optional), end_cursor (optional).
action=videos: Search public Facebook videos by keyword, optionally most recent first or live videos only. Returns video titles, URLs and view counts, plus an end_cursor. Pricing: 1 credit per call. Inputs: query (required), most_recent (optional), videos_live (optional), fields (optional), end_cursor (optional).
action=locations: Look up Facebook places by name (city, region, venue) and get their location_uid. The location_uid is only used to filter action=pages, action=people and action=posts; it is not a Marketplace location (use facebook_marketplace (action=city_coordinates) for that). Pricing: 1 credit per call. Inputs: query (required).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search keyword. pages: a brand or business name · people: a name · posts, videos: words in the text · locations: a city, place or landmark. Required for: pages, people, posts, videos, locations. | |
| action | Yes | Which operation to run. See the tool description for what each action returns and which parameters it needs. | |
| fields | No | Comma-separated list of response fields to include. Optional for: videos. | |
| end_time | No | Filter posts before this date (YYYY-MM-DD). Optional for: posts. | |
| end_cursor | No | Pagination cursor. Optional for: pages, people, posts, videos. | |
| start_time | No | Filter posts after this date (YYYY-MM-DD). Optional for: posts. | |
| most_recent | No | When "true", shows most recent videos first. Optional for: videos. | |
| videos_live | No | When "true", filters for live videos only. Optional for: videos. | |
| location_uid | No | Location UID from action=locations, to limit results to a place. Optional for: pages, people, posts. | |
| recent_posts | No | When "true", shows only recent posts. Optional for: posts. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining). | |
| creditsCharged | No | Credits charged for this call, or null if the endpoint did not report it. | |
| creditsRemaining | No | Credits left on the API key after this call, or null if not reported. |