Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "socialcrawl_find" and "socialcrawl_manage"
Only numbers and dates differ: this server embeds live figures in the definition, so the text moves without the contract changing.
⟨8 unchanged words⟩ the best endpoints (3 by default) of645646, each with the params the task supplies ⟨29 unchanged words⟩
⟨60 unchanged words⟩ and quotes a create/update and never creates it. rows_new alerts need track (id=monitors).
Changed the definition of "socialcrawl_account", "socialcrawl_collect", "socialcrawl_endpoint" and 3 more
⟨12 unchanged words⟩ ,"properties":{"cached":{"description":"Served fromCachecachehit: 0 credits.","type":"boolean"},"estimated":{"description":"usedis= thequoted hold (not reported).hold.","type":"boolean"},"quoted_max":{ ⟨16 unchanged words⟩ :"number"},"used":{"description":"Settled charge, afterAfter refunds.","type":"number"}},"type ⟨73 unchanged words⟩
Added "socialcrawl_account", "socialcrawl_collect", "socialcrawl_endpoint" and 3 more; removed "socialcrawl_check_balance", "socialcrawl_cohorts", "socialcrawl_discover" and 6 more; changed the definition of "socialcrawl_request" (10 tools before, 7 now)
Make a SocialCrawlCallAPIanRequestEndpoint
Make an API request to any of the 631 SocialCrawl endpoints. Fetches real-time data (profiles, posts, comments, transcripts, search results, products, offers and price history, reviews, apps, places and stores, jobs and salary ranges, news, market quotes and financial statements, congressional trade disclosures,CallSEOone
Changed the definition of "socialcrawl_discover", "socialcrawl_get_docs", "socialcrawl_list_endpoints" and 3 more
⟨44 unchanged words⟩ , and paging flag — filter by platform/search/method. 'capabilities': every cross-cutting parameter (label presets, relevance, judgments, include, since/stop_at_id, seen, max_pages, row filters, trim, fit) with what it does, its price, and every endpoint that supports it. 'plan': a job in plain words ('track mentions of Acme on TikTok and Reddit') turned into the exact priced calls to make, in order (needs a key). 'endpoint': one endpoint's complete usage guide — every ⟨125 unchanged words⟩ unknown. Without an API key everything except 'llms' and 'plan' still answers from bundled data ('status' needs ⟨5 unchanged words⟩
⟨19 unchanged words⟩ , and a first call — GET /v1/utility/quickstart. 'capabilities': every cross-cutting parameter once (label presets per row family, relevance, judgments, include, since/stop_at_id, seen, max_pages, row filters, trim, fit, download_media) with what it does, what it costs and every endpoint that supports it — GET /v1/utility/capabilities (filter with `param`). 'plan': turn a job in plain words (`query`, e.g. 'track mentions of Acme on TikTok and Reddit') into the exact priced calls to make, in order — GET /v1/utility/plan (needs an API key; free).
Certificate changed, valid to 2026-12-26
Changed the definition of "socialcrawl_get_docs", "socialcrawl_list_endpoints", "socialcrawl_list_platforms" and 2 more
⟨7 unchanged words⟩ intro), 'full' (comprehensive reference for all572575 endpoints), 'authentication', 'credits', 'pricing' (per-endpoint ⟨8 unchanged words⟩ cursor contract), 'caching' (TTLs and free hits), 'hydration' (the opt-in `include=` row joins, what each fills and what it costs), 'response-schema' (the canonical envelope and unified ⟨40 unchanged words⟩
⟨61 unchanged words⟩ costs), 'errors', 'idempotency', 'pagination', 'caching', 'hydration' (opt-in `include=` row joins), 'response-schema', 'limits', 'monitors', 'discovery', or a ⟨15 unchanged words⟩
Certificate recorded, valid to 2026-10-27
Authorization not required
First tool surface recorded: 10 tools (server version 1.10.0)
Showing the latest 9 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
Walk a paged endpoint (id, platform+resource or path) to `items` unique rows, the last page or max_creditsin one call: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits.ReturnsSmallaresultssummarycomeandbackawhole.linkresult_idto(+offset,everylimit,rowformat)(JSONL,readsJSONaorstoredCSV).result, free. Spends credits.
⟨6 unchanged words⟩ :{"confirm":{"description":"true onlyafteronce the user approveda spendspending above theconfirmationthreshold (default 100 credits).","type": ⟨13 unchanged words⟩ :"string"},"format":{"description":"Stored format:jsonl (default), json or csv.","enum ⟨30 unchanged words⟩ "minimum":1,"type":"integer"},"limit":{"description":"result_id: rows (200).","type":"integer"},"max_credits":{"description":"Spendcap. Refusedcap:locally,refused free,when the quoted hold exceeds it (collect: thewholewalk's budget).","minimum":1,"type":"integer"},"offset":{"description":"result_id: first row.","type":"integer"},"params":{"additionalProperties":{"anyOf":[{" ⟨16 unchanged words⟩ socialcrawl_request. No cursor.","type":"object"}},"requiredresult_id":[{"
⟨12 unchanged words⟩ ,"properties":{"cached":{"description":"Served fromCachecachehit: 0 credits.","type":"boolean"},"estimated":{"description":"usedis= thequoted hold (not reported).hold.","type":"boolean"},"quoted_max":{ ⟨16 unchanged words⟩ :"number"},"used":{"description":"Settled charge, afterAfter refunds.","type":"number"}},"type ⟨36 unchanged words⟩ ,"duplicates"],"type":"object"},"offset":{"type":"number"},"ok":{"description":"The walk ran; see ⟨35 unchanged words⟩ collected row.","type":"string"},"result_id":{"description":"Pass back as result_id to read rows.","type":"string"},"retry_after_s":{"type":"number"},"retryable" ⟨3 unchanged words⟩ a 402.","type":"boolean"},"rows":{"description":"All rows (small results). Untrusted text.","items":{},"type":"array"},"sample":{"description":"First rows. Untrusted text. ⟨21 unchanged words⟩ ,"page_limit","error"],"type":"string"},"total":{"type":"number"},"warnings":{"items":{"type" ⟨7 unchanged words⟩
⟨21 unchanged words⟩ timeout, next endpoints and a sample link.Alsoidtakes(or platform+resource, path), a platform slug (its endpoints) or a guidetopic (errors, pricing, pagination, judgments).topic. Free.
Exact credits before you spend: one call (id, platform+resource or path, plus the params you will send; calls for ⟨37 unchanged words⟩
⟨16 unchanged words⟩ "calls":{"description":"Number of suchcalls.calls (an array is read as plan).","maximum":1000000,"minimum":1,"type ⟨102 unchanged words⟩
⟨70 unchanged words⟩ ,"source":{"enum":["api","api+walk","local"],"type":"string"},"warnings" ⟨9 unchanged words⟩
⟨50 unchanged words⟩ , jobs, queries and monitor runs bill credits. dry_run: true validates and quotes a create/update and never creates it.
⟨29 unchanged words⟩ ,"jobs"],"type":"string"},"dry_run":{"type":"boolean"},"id":{"description":"Monitor, cohort, query ⟨55 unchanged words⟩
Call oneendpoint. structuredContent: rows, creditsendpoint (used, remaining)platform+resource,pagingor(has_moreid,next_cursoror path). Validated locally first (a bad call ⟨10 unchanged words⟩ threshold. A large page is cut at rowboundaries withboundaries;asocialcrawl_collectlinkresult_idtoreads thefull body.rest. Spends credits; needs SOCIALCRAWL_API_KEY.
⟨21 unchanged words⟩ },"confirm":{"description":"true onlyafteronce the user approveda spendspending above theconfirmationthreshold (default 100 credits).","type": ⟨6 unchanged words⟩ as socialcrawl_endpoint lists them, e.g. 'post.id,post.content.text,post.engagement.*'.post.engagement.*' (or an array). Cuts tokens.","type":"string"},"format ⟨34 unchanged words⟩ string"},"max_credits":{"description":"Spendcap. Refusedcap:locally,refused free,when the quoted hold exceeds it (collect: thewholewalk's budget).","minimum":1,"type ⟨120 unchanged words⟩
⟨12 unchanged words⟩ ,"properties":{"cached":{"description":"Served fromCachecachehit: 0 credits.","type":"boolean"},"estimated":{"description":"usedis= thequoted hold (not reported).hold.","type":"boolean"},"quoted_max":{ ⟨16 unchanged words⟩ :"number"},"used":{"description":"Settled charge, afterAfter refunds.","type":"number"}},"type ⟨136 unchanged words⟩ :{"type":"string"},"request_id":{"type":"string"},"result_id":{"description":"socialcrawl_collect result_id reads the full body.","type":"string"},"retry_after_s":{"type ⟨68 unchanged words⟩
⟨7 unchanged words⟩ :{"additionalProperties":{},"description":"JSONrequestbody for POST batch endpoints(e.g. youtube/videos,prism/profiles). Put array/object params here —e.g. { ids: ['dQw4w9WgXcQ'] } or { items: [{ platform: 'tiktok', handle: '@scout2015' }...] }.Ignored for GET endpoints. Use socialcrawl_list_endpoints to see which params belong in the body. For the web-scraping platform use the socialcrawl_web tool instead.","type":"object"},"idempotencyKeyconfirm":{"description":"Optional Idempotency-Key header. Lets youtruesafelyonlyretryafter thesameuserrequestapproved—areplaysspendreturnabove theoriginal responseconfirmationandthresholddeduct(default0100 credits(24h TTL).","minLength":16,"type":"stringboolean"},"methodfields":{"description":"HTTP method, only needed for a resource served by more thanRowonepaths(e.g.exactlyprism/jobs:asGETsocialcrawl_endpoint listsyour jobsthem,POST submits one).e.g.Inferred'post.id,post.content.text,post.engagement.*'.whenCutsomittedtokens.","type":sending a `body` selects the POST"string"},"format":{"description":"jsonvariant(default),whencsvone(canonicalexists,columns)otherwiseorGET.summary.","enum":["GET","POSTjson","PATCHcsv","DELETEsummary"],"type":"string"},"params":{"additionalPropertiesidempotencyKey":{"type":"string"},"description":"Query parameters as key-value pairsMakes(e.g.,a{retryhandlesafe:'charlidamelio' }). For GET endpointsathesereplayarereturns thequery string. For POST batch endpoints, putoriginalscalarresponsequeryforparams0herecredits (e.g. { hl: 'en' }24h)and the array/object body in `body`. Cross-cutting params work here too where an endpoint declares them.","minLength":`label` / `relevance` / `relevant_to` / `judgments` (row judgments)16,`include` (row joins)"type":"string"},`max_pages` / `seen` / `since` / `stop_at_id` (walks"max_credits":{"description":"Spendandcap.incrementalRefusedpolling)locally,`dry_run=1` (free,judgmentwhencostthepreview),quoted`fit=goal`hold+exceeds`goal`it (trimcollect: thepage to what awholegoalwalk'sneedsbudget).",`trim`."minimum":1,"type":"objectinteger"},"platformmax_items":{"description":"PlatformShowslugat(e.g.,most'tiktok',this'instagram',many'youtube')rows; the full page stays behind the result link.","enumminimum":["web","tiktok","instagram","youtube","twitter","linkedin","facebook","reddit","threads","pinterest","twitch","snapchat","truthsocial","telegram","kick","kwai","tiktokshop","perplexity","google","amazon","google_shopping","google_news","finance","google_trends","trustpilot","g2","google_play","app_store","tripadvisor","walmart","target","wayfair"1,"home_depottype",:"ebayinteger"},"etsymethod",:{"sephoradescription",:"aliexpressOnly for a resource served by several methods (prism/jobs). Inferred: a body selects POST.","hmenum",:["kohlsGET","klarnaPOST","gumtreePATCH","yelpDELETE"],"utilitytype",:"linktreestring"},"linkbioparams",:{"linkmeadditionalProperties",:{"komianyOf",:[{"pillartype",:["polymarketstring","hackernewsnumber","quoraboolean"]},{"douyinitems",:{"github$ref",:"tavily#/properties/params/additionalProperties/anyOf/0"},"navertype",:"rumblearray"}]},"bluesky",description"spotify:"Query params,"apple_music"e.g. { handle: 'x',"searchlimit: 10 }. Arrays join with commas (label). Sent as strings.","prismtype",:"content_analysisobject"},"on_page",platform"jobs:{",description"us_congress_trades:"Platform slug,"producthunte.g. 'tiktok'. An unknown slug gets a did-you-mean.","xiaohongshuminLength"]:1,"type":"string"},"resource":{"description":"Resource path(e.g.,'profile', 'post/comments', 'search'). A path-param endpoint takes the template plus thee.g.value'post/comments';inpath`params`params(resourceas 'jobs/{job_id}',params { job_id: '…'+})params.job_id, or the concretepath ('jobs/job_abc123').path.","minLength":1,"type":"string"} ⟨5 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"code":{"type":"string"},"credits":{"additionalProperties":false,"properties":{"cached":{"description":"Served from cache: 0 credits.","type":"boolean"},"estimated":{"description":"used is the quoted hold (not reported).","type":"boolean"},"quoted_max":{"description":"Hold taken up front.","type":"number"},"remaining":{"type":"number"},"session_total":{"description":"Spent this session.","type":"number"},"used":{"description":"Settled charge, after refunds.","type":"number"}},"type":"object"},"csv_rows":{"description":"format=csv: rows in the text CSV.","type":"number"},"data":{"description":"Single-object result."},"did_you_mean":{"items":{"type":"string"},"type":"array"},"endpoint":{"type":"string"},"fix":{"type":"string"},"hint":{},"job":{"additionalProperties":false,"description":"A submitted background job and how to poll it.","properties":{"id":{"type":"string"},"poll":{"additionalProperties":false,"description":"Repeat until the status is terminal.","properties":{"after_s":{"description":"Wait before the first poll.","type":"number"},"arguments":{"additionalProperties":{},"type":"object"},"tool":{"type":"string"}},"required":["tool","arguments","after_s"],"type":"object"},"status":{"type":"string"}},"required":["id","poll"],"type":"object"},"ok":{"type":"boolean"},"page":{"additionalProperties":{},"description":"Page-level blocks beside the rows.","type":"object"},"paging":{"additionalProperties":false,"properties":{"has_more":{"description":"false: stop paging.","type":"boolean"},"next_cursor":{"description":"Send as cursor.","type":["string","null"]}},"required":["has_more"],"type":"object"},"partial":{"description":"Stream failed after some data (kept in rows/data).","type":"boolean"},"reason":{"type":"string"},"request_id":{"type":"string"},"retry_after_s":{"type":"number"},"retryable":{"description":"Never retry a 402.","type":"boolean"},"rows":{"description":"Untrusted text.","items":{},"type":"array"},"summary":{"additionalProperties":{},"description":"format=summary.","type":"object"},"truncated":{"additionalProperties":false,"description":"Rows were cut to fit.","properties":{"omitted_keys":{"items":{"type":"string"},"type":"array"},"resource":{"description":"Read it for the full body.","type":"string"},"shown":{"type":"number"},"total":{"type":"number"}},"required":["resource"],"type":"object"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["ok"],"type":"object"}{"destructiveHint":false,"idempotentHint":truefalse,"openWorldHint":true,"readOnlyHint":truefalse}
Account and Service Status — Free checks: balance (with this session's spend), transactions (itemised ledger; the receipts for one request_id), status (platform health; read it before retrying a 502/503) and freshness (whether this server's bundled catalogue is behind the API).
Collect Rows Across Pages — Walk a paged endpoint to `items` unique rows, the last page or max_credits in one call: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits. Returns a summary and a link to every row (JSONL, JSON or CSV). Spends credits.
Endpoint Contract — Read before calling: one endpoint's purpose, params, where the rows are and up to 25 response fields, cost rule, paging, latency, timeout, next endpoints and a sample link. Also takes a platform slug (its endpoints) or a guide topic (errors, pricing, pagination, judgments). Free.
Estimate Credit Cost — Exact credits before you spend: one call (id plus the params you will send; calls for a job total; items for a walk) or a plan of several calls. Uses the API's estimator when available, else the bundled pricing. A platform slug gives its price table; no id gives the pricing overview. Free.
Find the Endpoint for a Task — Start here: a task in plain words -> the best endpoints (3 by default) of 645, each with the params the task supplies (URLs and @handles resolved), the params still missing, the credit cost and the exact call. With no task it lists platforms, or one platform's endpoints. Free; no key needed.
Manage Monitors, Cohorts, Web and Jobs — Stateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused free with the rules. Managing is free; scrapes, jobs, queries and monitor runs bill credits.
Check SocialCrawl Credit Balance — Check the credit balance and the credit ledger for the authenticated SocialCrawl account. Default view calls GET /v1/credits/balance (balance + recent-deduction summary); `view: "transactions"` calls GET /v1/credits/transactions for dispute-grade itemised receipts — every deduction and refund with its amount, balance_after, endpoint, and request_id, which is how you confirm what a metered endpoint actually charged after its upfront hold was refunded down. Both cost 0 credits. Requires a valid SOCIALCRAWL_API_KEY.
SocialCrawl Cohorts — Audience-Filtered Mention Search — Answer 'which of THESE specific public identities is talking about my keywords?' — the opposite of open social listening. You upload a panel of up to 10,000 platform-qualified public handles (instagram, tiktok, youtube, twitter, threads, bluesky, truth-social, kwai, twitch, linkedin), submit a keyword query bounded to a recent window, and read back the matching posts per member PLUS a coverage record for every member, including the ones that matched nothing — so a partial crawl can never read as 'nobody talked about you'. Actions: create, add_members (1,000 per call, upsert on external_id so …
SocialCrawl API Self-Discovery (utility endpoints) — The API describing itself, live, at 0 credits — the `/v1/utility/*` family. 'quickstart': everything needed for a first successful call (auth, base URL, response envelope, billing model, the full error taxonomy, rate limits, paging). 'catalog': every endpoint with its live metered-aware price, params, and paging flag — filter by platform/search/method. 'capabilities': every cross-cutting parameter (label presets, relevance, judgments, include, since/stop_at_id, seen, max_pages, row filters, trim, fit) with what it does, its price, and every endpoint that supports it. 'plan': a job in plain wo…
Get SocialCrawl Documentation — Retrieve SocialCrawl API documentation. Topics: 'overview' (compact intro), 'full' (comprehensive reference for all 631 endpoints), 'authentication', 'credits', 'pricing' (per-endpoint cost for every endpoint), 'errors', 'idempotency', 'pagination' (universal cursor contract), 'caching' (TTLs and free hits), 'hydration' (the opt-in `include=` row joins, what each fills and what it costs), 'judgments' (free default labels and relevance, the metered presets, and every control), 'batch-jobs' (batch endpoints and async background jobs of up to 5,000 items), 'response-schema' (the canonical envelo…
List Endpoints for a Platform — List endpoints with their full parameter contract — required + optional params, types, integer ranges, enum values, parameter couplings, CSV limits, pagination style, cache TTL, and per-endpoint pricing (including metered bands). Pass a `platform` for that platform's reference, or a `search` term to find an endpoint across all 67 platforms / 631 endpoints. Filter with `method`, `maxCost`, and `hydrating` (endpoints that can fill their own rows in one call via `include=`). Each endpoint also shows its featured params, its free and metered judgments (`label=` / `relevance=`), its cost levers (`…
List SocialCrawl Platforms — List all 67 platforms available through SocialCrawl (631 endpoints — social media, commerce, marketplaces & product reviews, retail (Amazon, Walmart, Target, Home Depot, eBay, Klarna, AliExpress, Etsy, Sephora, H&M, Kohl's, Wayfair, Gumtree, Google Shopping), app stores, places, travel & local (Tripadvisor, Yelp, Google Business), business & software reputation (Trustpilot, G2), jobs & salaries, markets & finance, US congressional trading, news, web research and full scraping/browser automation, on-page SEO audits, prediction markets, search trends, Korean search (Naver), Chinese social (Douy…
Manage SocialCrawl Monitors — Create and manage stateful monitors that re-run any SocialCrawl recipe (a registry endpoint or a Prism composite) on a cadence (hourly/daily/weekly/cron), deliver each result to a signed webhook, raise alerts on metric thresholds/changes, and accumulate a per-run time-series. 'Prism answers once; monitors watch it for you.' Actions: create, list, get, runs, timeseries, pause, resume, delete. Managing monitors costs 0 credits; each scheduled run bills the underlying recipe's normal cost plus a 1-credit scheduling premium. Requires a valid SOCIALCRAWL_API_KEY.
SocialCrawl Pricing & Credit Costs — Exact credit pricing for every one of the 631 SocialCrawl endpoints. 'overview' returns the tier ladder (347 standard / 240 advanced / 44 premium), every free endpoint, every flat override, all 130 metered endpoints with their min-max band and exact charging rule, cache TTLs, and the full refund matrix. 'endpoint' gives one endpoint's price, metered rule, price-driving parameters, paging cost, and worst case. 'platform' gives a platform's whole cost table. 'list' ranks and filters endpoints by cost (maxCost/minCost/model/search/sort) — e.g. "everything I can call for 1 credit" or "the most ex…
SocialCrawl Web Scraping & Browser Automation — Full web scraping, search, and browser automation (Firecrawl-backed). Sync reads: 'scrape' (URL → markdown/HTML/screenshot/links), 'search' (web search with page content), 'map' (discover a site's URLs), 'extract' (LLM structured data from a page). Async jobs (submit, then poll with job_get/job_list, stop with job_cancel): 'crawl' a whole site, 'batch_scrape' many URLs, 'agent' (autonomous multi-step web task). Change detection: monitor_create/list/get/update/delete/checks (re-check a URL on a cadence → webhook). Interactive browser: session_create/get/list, session_execute (run code in the l…
⟨7 unchanged words⟩ intro), 'full' (comprehensive reference for all575631 endpoints), 'authentication', 'credits', 'pricing' (per-endpoint ⟨20 unchanged words⟩ joins, what each fills and what it costs), 'judgments' (free default labels and relevance, the metered presets, and every control), 'batch-jobs' (batch endpoints and async background jobs of up to 5,000 items), 'response-schema' (the canonical envelope and unified ⟨40 unchanged words⟩
⟨65 unchanged words⟩ 'caching', 'hydration' (opt-in `include=` row joins), 'judgments' (free default labels/relevance and the metered presets), 'batch-jobs' (batches and background jobs), 'response-schema', 'limits', 'monitors', 'discovery', or a ⟨15 unchanged words⟩
⟨41 unchanged words⟩ `search` term to find an endpoint across all6567 platforms /575631 endpoints. Filter with `method`, `maxCost`, and `hydrating` ⟨5 unchanged words⟩ own rows in one call via `include=`). Each endpoint also shows its featured params, its free and metered judgments (`label=` / `relevance=`), its cost levers (`max_pages`, `seen`, `since`, `stop_at_id`) and its related endpoints. Search also matches parameter names and label presets. No API key required.
⟨254 unchanged words⟩ ,"content_analysis","on_page","jobs","us_congress_trades","producthunt","xiaohongshu"],"type":"string"},"search":{ ⟨32 unchanged words⟩
List all6567 platforms available through SocialCrawl (575631 endpoints — social media, commerce, marketplaces & ⟨55 unchanged words⟩ markets, search trends, Korean search (Naver), Chinese social (Douyin, Xiaohongshu), Product Hunt, content analysis, and cross-platform Prism composites). ⟨17 unchanged words⟩
Exact credit pricing for every one of the575631 SocialCrawl endpoints. 'overview' returns the tier ladder (329347 standard /211240 advanced /3544 premium), every free endpoint, every flat override, all71130 metered endpoints with their min-max band and exact ⟨69 unchanged words⟩ cap, and what a fully-joined page holds. 'judgments' lists every endpoint with free default labels/relevance, which presets are metered, and the hold each opt-in takes. On 'endpoint', passthe `include``params` (andthe`rows`)exactyouqueryintendyoutowill send — include, label, relevant_to, max_pages, …) and optionally `calls`, and the band becomesthe exactanupfrontitemised hold,itemisedper page, perjoin.call and for the whole job. Use this before spending credits. No API key required.
⟨18 unchanged words⟩ override, every metered band with its rule, judgments, cache TTLs, and the refund matrix. 'endpoint': one endpoint's exact price, metered rule, price-driving params, row joins, judgments, cost levers and worst case (needs platform + resource) — add`include`/`rows``params` (the exact query you will send) and `calls` for anexact quoteitemisedinsteadholdofand aband.whole-job budget. 'platform': the cost table for one platform ( ⟨7 unchanged words⟩ price across platforms. 'hydration': every `include=` row joinin the API, what eachonefills,what it costsitsperper-rowrowrate and what a fully-joined pageholds
Make an API request to any of the575631 SocialCrawl endpoints. Fetches real-time data (profiles, posts ⟨30 unchanged words⟩ , analytics, and cross-platform Prism composites) from6567 platforms. Most endpoints are GET (pass query params in `params`); batch endpoints (e.g. youtube/videos, prism/profiles, prism/post-stats) and background jobs (prism/jobs, up to 5,000 items) are POST — pass the array/object body in `body`. Path-param endpoints take the template plus the value in `params` (resource 'jobs/{job_id}', params { job_id }) or the concrete path. For web scraping/crawling/browser automation use the `socialcrawl_web` tool ⟨38 unchanged words⟩ (and metered rule) with every response,andon an endpoint that supports row joins it ⟨12 unchanged words⟩ you the join is available and what itcosts.costs, and on a judged list it quotes the hold for any metered `label=` / `relevant_to=` you sent (default judgments are free). Pass an optional idempotencyKey to make the request ⟨11 unchanged words⟩
⟨85 unchanged words⟩ "minLength":16,"type":"string"},"method":{"description":"HTTP method, only needed for a resource served by more than one (e.g. prism/jobs: GET lists your jobs, POST submits one). Inferred when omitted: sending a `body` selects the POST variant when one exists, otherwise GET.","enum":["GET","POST","PATCH","DELETE"],"type":"string"},"params":{"additionalProperties":{"type":"string" ⟨29 unchanged words⟩ 'en' }) and the array/object body in `body`. Cross-cutting params work here too where an endpoint declares them: `label` / `relevance` / `relevant_to` / `judgments` (row judgments), `include` (row joins), `max_pages` / `seen` / `since` / `stop_at_id` (walks and incremental polling), `dry_run=1` (free judgment cost preview), `fit=goal` + `goal` (trim the page to what a goal needs), `trim`.","type":"object"},"platform":{ ⟨69 unchanged words⟩ ,"content_analysis","on_page","jobs","us_congress_trades","producthunt","xiaohongshu"],"type":"string"},"resource":{"description":"Resource path (e.g., 'profile', 'post/comments', 'search'). A path-param endpoint takes the template plus the value in `params` (resource 'jobs/{job_id}', params { job_id: '…' }) or the concrete path ('jobs/job_abc123').","minLength":1,"type":"string"} ⟨5 unchanged words⟩
⟨44 unchanged words⟩ find an endpoint across all 65 platforms /572575 endpoints. Filter with `method`, `maxCost`, and`maxCost`.`hydrating` (endpoints that can fill their own rows in one call via `include=`). No API key required.
⟨39 unchanged words⟩ ,"full"],"type":"string"},"hydrating":{"description":"Only show endpoints that can fill their own rows in the same call via an `include=` row join (e.g. a search page that can carry engagement counts). Use it to find the one call that answers a question instead of a page plus one lookup per row.","type":"boolean"},"maxCost":{"description":"Only show endpoints that ⟨193 unchanged words⟩
Only numbers and dates differ: this server embeds live figures in the definition, so the text moves without the contract changing.
List all 65 platforms available through SocialCrawl (572575 endpoints — social media, commerce, marketplaces & ⟨85 unchanged words⟩
Exact credit pricing for every one of the572575 SocialCrawl endpoints. 'overview' returns the tier ladder (327329 standard /210211 advanced / 35 premium), every free endpoint, every flat override, all4171 metered endpoints with their min-max band and exact ⟨46 unchanged words⟩ credit" or "the most expensive endpoints". 'hydration' catalogues every opt-in `include=` row join — what each fills, its per-row rate, its row cap, and what a fully-joined page holds. On 'endpoint', pass the `include` (and `rows`) you intend to send and the band becomes the exact upfront hold, itemised per join. Use this before spending credits. No API key required.
⟨34 unchanged words⟩ exact price, metered rule, price-driving params, row joins, and worst case (needs platform + resource).— add `include`/`rows` for an exact quote instead of a band. 'platform': the cost table for one platform (needs platform). 'list': rank/filter endpoints by price across platforms. 'hydration': every `include=` row join in the API, what each one fills, what it costs per row and what a fully-joined page holds (optionally scoped with `platform`).","enum":["overview","endpoint","platform","list","hydration"],"type":"string"},"include":{"description":"endpoint: the `include=` row-join tokens you intend to send (comma-separated, e.g. 'engagement' or 'engagement,channel'). Turns the quoted band into the exact hold for that call, itemised per join. Costs nothing to ask.","type":"string"},"limit":{"description":"list: maximum rows ⟨213 unchanged words⟩ 'jobs/{job_id}').","type":"string"},"rows":{"description":"endpoint: the row cap you intend to send alongside `include` (the endpoint's own `limit`). A row join holds per row, so capping the rows caps the credits — quote it before you spend it.","minimum":1,"type":"integer"},"search":{"description":"list: ⟨31 unchanged words⟩
Make an API request to any of the572575 SocialCrawl endpoints. Fetches real-time data (profiles, posts ⟨106 unchanged words⟩ endpoint's price (and metered rule) with everyresponse.response, and on an endpoint that supports row joins it either quotes the exact hold for the `include=` you sent or tells you the join is available and what it costs. Pass an optional idempotencyKey to make the request ⟨11 unchanged words⟩