# Monocrawl

> Social, search, commerce and web data behind one API key and one credit balance. The catalogue contains 648 operations across 80 platform groups; check each operation's current availability before retrieving. Base URL `https://www.monocrawl.com/v1`; auth via the `x-api-key` header. Confirmed uncharged or refunded failures report zero; `credits_used: null` with `pending_reconciliation` means accounting is unresolved. Synthetic examples exist only under the explicit `/sandbox` surface.

## Docs

- [Quickstart](https://www.monocrawl.com/docs/quickstart): from a new account to a parsed response
- [Authentication](https://www.monocrawl.com/docs/authentication): key format, headers, per-key limits
- [API reference](https://www.monocrawl.com/docs/api-reference): path shape, envelope, pagination, batch
- [Endpoint reference](https://www.monocrawl.com/docs/endpoints): every operation with parameters and cost
- [Monitor relevance filters](https://www.monocrawl.com/docs/monitors#relevance-api): optional relevance_enabled, relevance_prompt and exclusions on every monitor; setup examples, undecided work, saved evidence, results and alert history
- [Panorama Search](https://www.monocrawl.com/docs/panorama-search): dashboard social mentions, optional complaint analysis and labelled CSV. Public search API responses do not include this dashboard analysis; no public API-key endpoint or dedicated MCP tool exposes these labels.
- [Errors](https://www.monocrawl.com/docs/errors): every error type, status and remedy
- [Pricing](https://www.monocrawl.com/pricing): 1,000 free credits every month, then monthly plans with a fixed allowance

## Machine-readable

- Every guide has a Markdown version: append `.md` to its /docs URL or request `Accept: text/markdown`. Example: https://www.monocrawl.com/docs/quickstart/agents.md
- [Documentation directory](https://www.monocrawl.com/docs-markdown/index): all guides and platform references
- Platform-scoped catalogue: `https://www.monocrawl.com/llms/PLATFORM.txt`, for example https://www.monocrawl.com/llms/tiktok.txt
- [Quickstart](https://www.monocrawl.com/docs/quickstart.md): From a new account to a parsed response.
- [Using an AI agent](https://www.monocrawl.com/docs/quickstart/agents.md): Connect, verify and retrieve within an explicit budget.
- [Security & data handling](https://www.monocrawl.com/docs/security.md): Credential controls, request data, stored records and retention.
- [Data availability](https://www.monocrawl.com/docs/data-availability.md): Nulls, missing fields, partial results, source limits and freshness.
- [Labels & evidence](https://www.monocrawl.com/docs/labels.md): Bounded row intelligence, exact sentence evidence, free previews, goal fitting and recall.
- [Credits](https://www.monocrawl.com/docs/credits.md): Allowances, connection caps, charges, refunds and unresolved accounting.
- [Batch requests](https://www.monocrawl.com/docs/batch.md): Independent operations, per-item failures, receipts and recovery.
- [Streaming (SSE)](https://www.monocrawl.com/docs/streaming.md): Search progress, final results, disconnects and replay.
- [AI agent integration](https://www.monocrawl.com/docs/ai-agents.md): MCP documentation tools, Markdown guides and scoped machine-readable references.
- [n8n](https://www.monocrawl.com/docs/n8n.md): Import a bounded workflow with credential storage and explicit result checks.
- [LangChain](https://www.monocrawl.com/docs/langchain.md): Runnable agent with discovery, allowlisted retrieval and budget controls.
- [Vercel AI SDK](https://www.monocrawl.com/docs/vercel-ai-sdk.md): A bounded tool loop that retains source evidence and credit receipts.
- [Authentication](https://www.monocrawl.com/docs/authentication.md): Key format, headers, per-key limits.
- [API reference](https://www.monocrawl.com/docs/api-reference.md): Paths, envelope, batch, pagination.
- [Endpoints](https://www.monocrawl.com/docs/endpoints.md): Every operation, parameters and cost.
- [Platforms](https://www.monocrawl.com/docs/platforms.md): One reference page per platform, from the registry.
- [Which endpoint?](https://www.monocrawl.com/docs/which-endpoint.md): From the job to the operation.
- [Recipes](https://www.monocrawl.com/docs/recipes.md): Pasteable flows, costs from the registry.
- [Panorama](https://www.monocrawl.com/docs/panorama.md): Choose the Search workspace or API workflows; quickstart, source coverage, partial results and MCP.
- [Responses & schemas](https://www.monocrawl.com/docs/responses.md): The envelope, unified shapes, honest nulls.
- [Endpoint schemas](https://www.monocrawl.com/docs/schemas.md): Field types, examples and downloadable JSON Schema for reviewed platform endpoints.
- [Computed fields](https://www.monocrawl.com/docs/computed-fields.md): Formulas, units, denominators and missing-input rules.
- [Runnable workflows](https://www.monocrawl.com/docs/workflows.md): Six linked platform journeys with pagination, saved results and budgets.
- [Production guide](https://www.monocrawl.com/docs/production-checklist.md): Request wrapper, recovery, budgets, partial results and logging.
- [Integration testing](https://www.monocrawl.com/docs/testing.md): Offline fixtures, free sandbox samples and capped live smoke tests.
- [Versioning](https://www.monocrawl.com/docs/versioning.md): Additive /v1, deprecation notice, sunset headers.
- [Pagination & caching](https://www.monocrawl.com/docs/pagination-caching.md): Continuation contracts and free cached responses.
- [Rate limits](https://www.monocrawl.com/docs/rate-limits.md): 600/min, 25 concurrent.
- [Jobs, webhooks & monitors](https://www.monocrawl.com/docs/jobs-webhooks.md): Async jobs, signed deliveries, timeseries.
- [Search](https://www.monocrawl.com/docs/research.md): Search types, options, article text, history and exports.
- [Integrations](https://www.monocrawl.com/docs/integrations.md): Claude Code, Codex, Cursor, n8n, LangChain.
- [MCP server](https://www.monocrawl.com/docs/mcp.md): Connect agents and create monitors with optional relevance filtering; Claude setup and tool examples.
- [Errors](https://www.monocrawl.com/docs/errors.md): Every error type, status and remedy.
- [Endpoint pricing](https://www.monocrawl.com/docs/endpoint-pricing.md): Credit tiers, refunds, rate limits.

- [llms-full.txt](https://www.monocrawl.com/llms-full.txt): the whole live catalogue as markdown, regenerated from the endpoint registry
- [OpenAPI 3.1](https://www.monocrawl.com/openapi.json): the same registry as an importable spec
- [Agent skill](https://www.monocrawl.com/agent-onboarding/SKILL.md): one-read onboarding for coding agents

## For agents

- [MCP server](https://www.monocrawl.com/docs/mcp): hosted Model Context Protocol endpoint at `https://www.monocrawl.com/mcp` — tools for endpoints, balance and monitors, same metering and limits as the REST API
- [MCP monitor example](https://www.monocrawl.com/docs/mcp#monitor-filtering): preview, create, read and update the same relevance-filtered monitors as the dashboard; schedules continue with the client closed
- Browser sign-in for coding agents: `https://www.monocrawl.com/mcp/oauth`. Connection commands and the skill contain no API keys. Guide: https://www.monocrawl.com/docs/integrations.
- Public MCP discovery at `https://www.monocrawl.com/mcp`: initialize, tools/list, list_endpoints, get_endpoint and get_docs require no key. get_endpoint links the exact operation guide and reviewed response schema when available. get_docs reads the guides in bounded chunks; continue with its cursor. Data and account tools require an API key or supported OAuth sign-in.
- Runtime REST discovery: `GET /v1/utility/endpoints` (catalogue), `GET /v1/utility/quickstart` (cheapest live call), `GET /v1/credits/balance` (funds) — all free, key required