What is Social Search?

Social Search is a single search bar that fans out across the indexable corners of Facebook — Posts, Pages, People, the Meta Ad Library, and Marketplace — and returns a unified, structured response. Use it from the browser UI on this page, or call the same five endpoints programmatically via the public API. Same data, same credit cost, same filters in either direction.

What you can search for

Pick a category from the dropdown at the top of the search bar. Each category maps to a REST endpoint under /v1/facebook/search/<category> in the public API.

Posts

/facebook/search/posts

Full-text search across public Facebook posts. Filter by date range, engagement (likes / comments / shares), language, and post type.

Good for: Brand-mention monitoring, trend tracking, finding viral content in a niche, sourcing user-generated content.

Pages

/facebook/search/pages

Find Facebook Pages by name or topic. Returns page ID, category, follower count, country, verification status, and the public bio.

Good for: Competitor discovery, influencer shortlisting, building a CRM of pages in a vertical, lead generation for B2B outreach.

People

/facebook/search/people

Public-profile search. Returns name, profile URL, work/education snippets (where users have made them public), and rough location.

Good for: Recruiting research, prospect enrichment, finding the right person inside a company to reach out to.

Ads

/facebook/search/ads

Search the Meta Ad Library — active and historical creatives, ad copy, spend ranges where Meta discloses them, target geographies, and the advertiser page behind each ad.

Good for: Competitor ad teardown, creative inspiration, watching how a competitor's funnel evolves week-over-week, regulated-industry compliance checks.

Marketplace

/facebook/search/marketplace

Facebook Marketplace listings — product title, price, seller, location, condition, listing date, and the photo URL when public.

Good for: Resale arbitrage research, second-hand market price discovery, dropshipping competitor checks, regional pricing data.

More platforms (coming)

Roadmap

Instagram, X (Twitter), and LinkedIn search are on the roadmap. The dropdown in the search bar shows them as disabled until they ship — subscribe to the changelog or vote on the priority by emailing support.

Common use cases

Most teams reach for Social Search to do one of these four jobs. Each one combines two endpoints from the grid above into a concrete workflow.

Competitor monitoring

Combines Ads + Pages

Pull every ad your top three competitors are running each Monday morning. Diff the creative set against last week's pull and flag new launches into Slack. Combine the Ads endpoint with the Pages endpoint to catch sister-brand pivots before they show up on industry blogs.

Trend tracking

Combines Posts

Watch the engagement curve on posts containing a target keyword over time. Sort by likes-per-hour to spot a meme or news story while it's still climbing. Backfill historical data by querying with date ranges to build your own trend index.

Influencer discovery

Combines Pages

Search Pages by topic + minimum follower count to build an outreach list. Hydrate each page with engagement metrics via the page-details endpoint to filter out inactive accounts. Export the result as CSV for your CRM in one call.

Lead generation

Combines Pages + People

Find local businesses in a specific city + category, enrich each with the public contact info on their page (website, phone, email), and pipe straight into your sales tool. Hit the rate limits comfortably even on the Pro plan for a few thousand leads a month.

Under the hood — call it from your own code

The browser UI on this page wraps the same REST API you'd hit from Python, n8n, or your backend. Here's the minimum viable Pages search:

curl -X POST https://api.socialapis.io/v1/facebook/search/pages \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "vegan bakery",
    "filters": {
      "country": "DE",
      "minFollowers": 1000
    }
  }'

Every endpoint returns JSON with results[], pagination, and a request_id you can quote in a support email if something looks off. Full request/response schemas plus copy-paste code in JavaScript, Python, PHP, Java, and Go are at /api-sources/facebook-search-pages.

Frequently asked questions

What platforms does Social Search cover today?

Facebook is the only platform that's live right now, with five search categories: Posts, Pages, People, Ads (Meta Ad Library), and Marketplace. Instagram, X (Twitter), and LinkedIn are visible in the dropdown but disabled — they're on the roadmap, not shipped. We add new endpoints monthly and ship platform expansions when the upstream data is reliable enough to give the same SLA as our Facebook endpoints.

Are the results real-time, or are they cached?

Posts, Pages, People, and Marketplace queries are served live from the upstream source — the data you see is the data Facebook is showing at the moment you call the endpoint. The Ads endpoint returns Meta Ad Library snapshots which lag by 24–48 hours because Meta itself indexes them on that cadence. We don't cache results between users; each call counts against your credit balance and returns a fresh response.

Can I use Social Search programmatically via the public API?

Yes. Every category on this page is also a REST endpoint under /v1/facebook/search/<category>. The browser UI is just a thin layer over the public API — same response shape, same credit cost, same filters. Full documentation, request/response schemas, and copy-paste code in JavaScript, Python, cURL, PHP, Java, and Go are at /api-sources/facebook-search-pages.

What are the rate limits?

Default per-API-key limits apply: 10 requests/minute on the Free tier, 100/minute on Pro and above. Custom and enterprise plans get higher dedicated limits (200–1,000/minute) plus the option of a burst-tolerant token-bucket policy. If you're building a one-off bulk export, contact support — we'll temporarily raise your ceiling rather than have you re-architect around a queue.

Can I export the results to CSV or push them to a database?

From the browser UI, yes — the results panel includes an export button that hands back CSV or JSON of the current result set. For programmatic use, the API returns JSON you can pipe into anything: BigQuery, Postgres, Airtable, a spreadsheet via n8n/Make/Zapier. We publish maintained templates for the common workflows in the docs.

Try Social Search now

The search bar at the top of this page is live — type a query and hit Search to see what comes back. Free accounts include enough credits to evaluate any of the five categories before you decide whether to upgrade.

Create a free API key  ·  See pricing  ·  Browse all API endpoints