Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Fastcrawl Net Search API
version: 0.8.0
description: 'Operations tagged Search across 2 of this provider''s published API definitions: fastcrawl-net-openapi.json, mcp-fastcrawl-net-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://fastcrawl.net/api/v1
security:
- bearerAuth: []
tags:
- name: Search
paths:
/search:
post:
summary: Web search
operationId: search
description: 'Ranked web results. Add include_content to also get the first N results'' page markdown in the same call: 1 credit for the search, 1 credit per content page (a scrape-cache hit is free), and a page that fails comes back content: null + content_error while the request still returns 200. REST only - the MCP search tool stays one credit per call.'
requestBody:
required:
- query
content:
application/json:
schema:
type: object
required:
- query
properties:
query:
type: string
description: Search query.
limit:
type: integer
minimum: 1
maximum: 20
description: Max results (default 5).
include_content:
type: integer
minimum: 0
maximum: 5
description: 'Also return page markdown for the first N results (0 or absent = results only; 400 above 5). The whole request - search plus fetches - has a 60s budget; on budget the unfetched rows come back content: null + content_error: budget exceeded.'
responses:
'200':
description: Results; with include_content the first N rows carry page markdown in content.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
query:
type: string
results:
type: array
items:
type: object
properties:
title:
type: string
url:
type: string
snippet:
type: string
content:
type:
- string
- 'null'
description: Page markdown for the rows include_content covered; null for rows past N and when the fetch failed.
content_error:
type:
- string
- 'null'
description: Why content is null (target_not_found, scrape_empty_content, target_blocked, budget exceeded, ...). null on success.
'400':
description: query missing, or include_content above 5 (invalid_request)
'401':
description: missing_api_key / invalid_api_key - body carries remediation hint + WWW-Authenticate header
'422':
description: search failed (search backend down)
'429':
description: plan limit (error_code monthly_limit|daily_limit|rate_limit)
tags:
- Search
servers:
- url: https://fastcrawl.net/api/v1
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
x-refined-from:
- fastcrawl-net-openapi.json
- mcp-fastcrawl-net-openapi.json