--- type: "firecrawl-provider" description: "Inference-backed public X research with sourced structured outputs." use_when: "Public post research.\n\nPublic profile and account post research." categories: "Social" capabilities: 4 credits_per_call: 30 --- # X on Firecrawl Alexandria Inference-backed public X research with sourced structured outputs. - Categories: Social - Category index: [Social category](https://firecrawl.dev/alexandria/agents/categories/social) - Provider key: `x-com` - Access: Firecrawl credits - Cost: 30 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/x-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/x-com/openapi.json) ## Capabilities - [Search posts](https://firecrawl.dev/alexandria/agents/providers/x-com/posts/search): Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. - [Inspect a post](https://firecrawl.dev/alexandria/agents/providers/x-com/posts/lookup): Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. - [Inspect a profile](https://firecrawl.dev/alexandria/agents/providers/x-com/users/lookup): Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. - [Research account posts](https://firecrawl.dev/alexandria/agents/providers/x-com/users/posts): Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. ## 1. Choose this provider when Public post research. Public profile and account post research. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "x-com", "capability": "posts/search", "options": { "query": "Firecrawl Alexandria", "limit": 3 } } ``` ## 3. Add provider options Use only the options needed for the task: - `query` (string, required): Keyword, hashtag or semantic research query. Example: `` - `limit` (number): Maximum output records, not a bound on upstream fetched items. Example: `5` - `from_date` (string): Inclusive UTC date YYYY-MM-DD. Example: `` - `to_date` (string): Inclusive UTC date YYYY-MM-DD. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "x-com", capability: "posts/search", options: { query: "Firecrawl Alexandria", limit: 3, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "x-com", "capability": "posts/search", "options": { "query": "Firecrawl Alexandria", "limit": 3 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "x-com", "capability": "posts/search", "options": { "query": "Firecrawl Alexandria", "limit": 3 } } }' ``` ### CLI ```sh firecrawl scrape 'x-com/posts/search' \ --options '{"query":"Firecrawl Alexandria","limit":3}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "x-com", "capability": "posts/search", "options": { "query": "Firecrawl Alexandria", "limit": 3 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "x-com", "capability": "posts/search", "options": { "query": "Firecrawl Alexandria", "limit": 3 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "data": [ { "id": "2107212291133575625", "username": "boardyai", "url": "https://x.com/boardyai/status/2107212291133575625", "text": "@andrewdsouza hey Andrew, take a look. Firecrawl's Alexandria: one key for ~200 licensed data providers for agent teams. I can help them reach those builders.", "name": "Boardy", "description": "I'm an AI superconnector who's made hundreds of thousands of introductions within my network of 250,000+ professionals. \n\nWant one? DM me to get started.", "created_at": "2026-10-05T20:52:14.000Z", "public_metrics": { "like_count": 0, "repost_count": 0, "reply_count": 0 } }, { "id": "2107212255574053023", "username": "juampitech", "url": "https://x.com/juampitech/status/2107212255574053023", "text": "Since we launched Alexandria at Firecrawl, my workflows became smoother\n\nWe built Alexandria to be the knowledge library for superintelligence (SI)\n\nOne place where your agent can find a source, see what it holds and pull from it\n\nHere are some of my favorite benefits:\n\nšŸ”‘ One Firecrawl key instead of 10 signups, API keys and invoices\n\nšŸ”“ Licensed data from official providers, not burning credits scraping\n\nšŸ“š ~200 providers across 25 categories, for all use cases\n\nHere's how it works:", "name": "Juampi", "description": "I do tech stuff and share it online || Growth @firecrawl", "created_at": "2026-10-05T20:52:06.000Z", "public_metrics": { "like_count": 3, "repost_count": 0, "reply_count": 2 } }, { "id": "2107059682150088830", "username": "RichOBray", "url": "https://x.com/RichOBray/status/2107059682150088830", "text": "There is no excuse for boring visuals anymore.\n\nMade this in a couple of hours with Opus 5.5 and data from Firecrawl Alexandria.", "name": "Richard Oliver Bray", "description": "Developer experience @firecrawl (prev. @betterstackhq). Father of 2, married to 1. Working on https://t.co/q2vAh8TuNy", "created_at": "2026-10-05T10:45:50.000Z", "public_metrics": { "like_count": 6, "repost_count": 0, "reply_count": 1 } } ], "meta": { "citations": [ "https://x.com/i/status/2107212255574053023", "https://x.com/i/status/2107059682150088830", "https://x.com/i/status/2107212291133575625" ] } } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Search posts - Capability: `posts/search` - Description: Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. - Instructions: Research public X posts with a sourced summary and structured evidence; not exact recent-search pagination. - Cost: 30 credits per call - Capability file: [Search posts](https://firecrawl.dev/alexandria/agents/providers/x-com/posts/search) Accepted options: - `query` (string, required): Keyword, hashtag or semantic research query. Example: `` - `limit` (number): Maximum output records, not a bound on upstream fetched items. Example: `5` - `from_date` (string): Inclusive UTC date YYYY-MM-DD. Example: `` - `to_date` (string): Inclusive UTC date YYYY-MM-DD. Example: `` Response schema example: ```json { "data": [ { "id": "2107212291133575625", "username": "boardyai", "url": "https://x.com/boardyai/status/2107212291133575625", "text": "@andrewdsouza hey Andrew, take a look. Firecrawl's Alexandria: one key for ~200 licensed data providers for agent teams. I can help them reach those builders.", "name": "Boardy", "description": "I'm an AI superconnector who's made hundreds of thousands of introductions within my network of 250,000+ professionals. \n\nWant one? DM me to get started.", "created_at": "2026-10-05T20:52:14.000Z", "public_metrics": { "like_count": 0, "repost_count": 0, "reply_count": 0 } }, { "id": "2107212255574053023", "username": "juampitech", "url": "https://x.com/juampitech/status/2107212255574053023", "text": "Since we launched Alexandria at Firecrawl, my workflows became smoother\n\nWe built Alexandria to be the knowledge library for superintelligence (SI)\n\nOne place where your agent can find a source, see what it holds and pull from it\n\nHere are some of my favorite benefits:\n\nšŸ”‘ One Firecrawl key instead of 10 signups, API keys and invoices\n\nšŸ”“ Licensed data from official providers, not burning credits scraping\n\nšŸ“š ~200 providers across 25 categories, for all use cases\n\nHere's how it works:", "name": "Juampi", "description": "I do tech stuff and share it online || Growth @firecrawl", "created_at": "2026-10-05T20:52:06.000Z", "public_metrics": { "like_count": 3, "repost_count": 0, "reply_count": 2 } }, { "id": "2107059682150088830", "username": "RichOBray", "url": "https://x.com/RichOBray/status/2107059682150088830", "text": "There is no excuse for boring visuals anymore.\n\nMade this in a couple of hours with Opus 5.5 and data from Firecrawl Alexandria.", "name": "Richard Oliver Bray", "description": "Developer experience @firecrawl (prev. @betterstackhq). Father of 2, married to 1. Working on https://t.co/q2vAh8TuNy", "created_at": "2026-10-05T10:45:50.000Z", "public_metrics": { "like_count": 6, "repost_count": 0, "reply_count": 1 } } ], "meta": { "citations": [ "https://x.com/i/status/2107212255574053023", "https://x.com/i/status/2107059682150088830", "https://x.com/i/status/2107212291133575625" ] } } ``` ### Inspect a post - Capability: `posts/lookup` - Description: Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. - Instructions: Analyze a known public post with X Search thread fetch; exact retrieval must be live verified. - Cost: 30 credits per call - Capability file: [Inspect a post](https://firecrawl.dev/alexandria/agents/providers/x-com/posts/lookup) Accepted options: - `post_id` (string, required): Exact numeric X post ID. Example: `` Response schema example: ```json { "data": [ { "id": "2037202150690844778", "username": "ericciarla", "url": "https://x.com/ericciarla/status/2037202150690844778", "text": "Our @firecrawl integration with @n8n_io is live šŸ”„", "name": "Eric Ciarla (hiring)", "description": "Co-Founder @ Firecrawl (YC S22). Previously Mendable.", "created_at": "2026-03-26T16:16:56.000Z", "public_metrics": { "like_count": 10, "repost_count": 0, "reply_count": 3 } } ], "meta": { "citations": [ "https://x.com/i/status/2037202150690844778" ] } } ``` ### Inspect a profile - Capability: `users/lookup` - Description: Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. - Instructions: Research one public X profile using Grok user search; unknown metrics remain null. - Cost: 30 credits per call - Capability file: [Inspect a profile](https://firecrawl.dev/alexandria/agents/providers/x-com/users/lookup) Accepted options: - `username` (string, required): X handle, optionally prefixed with @. Example: `` Response schema example: ```json { "data": [ { "id": "1796642877172551682", "username": "firecrawl", "url": "https://x.com/firecrawl", "text": null, "name": "Firecrawl - @firecrawl", "description": "Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. šŸ”„", "created_at": null, "public_metrics": { "followers_count": 89243 } } ], "meta": { "citations": [ "https://x.com/i/user/1796642877172551682" ] } } ``` ### Research account posts - Capability: `users/posts` - Description: Citation-backed interpreted evidence, with summary and explicit coverage limitations. No cursor pagination. - Instructions: Analyze a sample of posts from one account, with a date range. Not a complete paginated timeline. - Cost: 30 credits per call - Capability file: [Research account posts](https://firecrawl.dev/alexandria/agents/providers/x-com/users/posts) Accepted options: - `username` (string, required): X handle, optionally prefixed with @. Example: `` - `limit` (number): Maximum output records, not a bound on upstream fetched items. Example: `5` - `from_date` (string): Inclusive UTC date YYYY-MM-DD. Example: `` - `to_date` (string): Inclusive UTC date YYYY-MM-DD. Example: `` Response schema example: ```json { "data": [ { "id": "2105691794163773870", "username": "firecrawl", "url": "https://x.com/firecrawl/status/2105691794163773870", "text": "More packs are on the way as we keep adding providers to Alexandria.", "name": "Firecrawl", "description": "Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. šŸ”„", "created_at": "2026-10-01T16:10:20.000Z", "public_metrics": { "like_count": 6, "repost_count": 1, "reply_count": 1 } }, { "id": "2105691791877869844", "username": "firecrawl", "url": "https://x.com/firecrawl/status/2105691791877869844", "text": "Introducing the People Enrichment Pack.\n\nApollo, FullEnrich & Data Legion are live in Alexandria, so your agents can:\n\n- Find buyers and their work emails\n- Find talent by skills and job history\n- Get company size and funding", "name": "Firecrawl", "description": "Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. šŸ”„", "created_at": "2026-10-01T16:10:19.000Z", "public_metrics": { "like_count": 446, "repost_count": 23, "reply_count": 27 } } ], "meta": { "citations": [ "https://x.com/i/status/2105691794163773870", "https://x.com/i/status/2105691791877869844" ] } } ```