Facebook

Search Facebook Posts

Search for Facebook posts globally by keyword. Supports date filtering, sorting, and location filtering.

Price: $0.008 per page. Free tier: 50 requests/month.

get/v1/facebook/posts

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/facebook/posts
  • Auth: API key in header X-API-Key

Query parameters

querystring required

Search query (max 500 characters)

location_idstring

Facebook location ID from /v1/facebook/locations, used to scope posts to that place. Digits only, maximum 64 characters.

pagesinteger

Number of pages to fetch and merge into one response (1-15). Billed per page.

start_datestring

Filter posts from this date (YYYY-MM-DD)

end_datestring

Filter posts until this date (YYYY-MM-DD)

sort_by'most_recent' | 'relevance'

Sort order for results. most_recent returns the newest posts first; relevance is the default.

get_sentimentboolean

Set to true to add AI emotion analysis to each post. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any post that cannot be scored returns sentiment: null.

Response

Successful response

countnumber nullable
pagesnumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.