replynodes-com Webcontext API
The webcontext API from replynodes-com — 4 operation(s) for webcontext.
The webcontext API from replynodes-com — 4 operation(s) for webcontext.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/replynodes-com:replynodes-com-webcontext-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: ReplyNodes Fetcher Webcontext API
version: v1
description: 'Read-only data APIs for AI agents. Bearer auth. Prepaid credits / free tier.
Click **Authorize** and paste ONLY the API key (no "Bearer" prefix) — Swagger adds it automatically.'
servers:
- url: https://api.replynodes.com
security:
- bearerAuth: []
tags:
- name: webcontext
paths:
/v1/webcontext/scrape:
get:
operationId: webcontext_scrape
summary: Fetch one URL as clean Markdown
description: Fetch one URL and return clean, main-content Markdown plus normalized metadata, links, and images. Backed by a privately deployed webclaw-server instance; upstream implementation details are never exposed.
tags:
- webcontext
parameters:
- name: url
in: query
required: true
description: Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.
schema:
type: string
format: uri
- name: include_selectors
in: query
required: false
description: Comma-separated CSS selectors to include (e.g. "article,.content").
schema:
type: string
- name: exclude_selectors
in: query
required: false
description: Comma-separated CSS selectors to exclude (e.g. "nav,.sidebar,footer").
schema:
type: string
- name: max_chars
in: query
required: false
description: Maximum number of Unicode code points of Markdown to return (1-1048576). A longer page is cut at the last line break (or whitespace) in the second half of the budget; data.truncated is true and data.markdown_chars is the full length. Links and images are still listed from the full page. Priced the same with or without max_chars. A non-integer or out-of-range value is rejected with 400 invalid_request.
schema:
type: integer
minimum: 1
maximum: 1048576
security: []
responses:
'200':
description: Success response.
headers:
X-Request-Id:
description: Correlation identifier echoed as meta.request_id.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WebContextScrapeResponse'
'400':
description: Normalized error with code invalid_request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'429':
description: Normalized error with code rate_limited.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
headers:
Retry-After:
description: Seconds until the quota window resets.
schema:
type: integer
'502':
description: Normalized error with code upstream_unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'503':
description: Normalized error with code degraded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
/v1/webcontext/crawl:
get:
operationId: webcontext_crawl
summary: Crawl same-origin links from a URL
description: Crawl same-origin links starting from a URL and return normalized page results. max_pages/max_depth are clamped server-side regardless of the requested value.
tags:
- webcontext
parameters:
- name: url
in: query
required: true
description: Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.
schema:
type: string
format: uri
- name: max_pages
in: query
required: false
description: Maximum pages to crawl; clamped to 1..50.
schema:
type: integer
minimum: 1
maximum: 50
- name: max_depth
in: query
required: false
description: Maximum link depth; clamped to 1..3.
schema:
type: integer
minimum: 1
maximum: 3
security:
- bearerAuth: []
responses:
'200':
description: Success response.
headers:
X-Request-Id:
description: Correlation identifier echoed as meta.request_id.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WebContextCrawlResponse'
'400':
description: Normalized error with code invalid_request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'429':
description: Normalized error with code rate_limited.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
headers:
Retry-After:
description: Seconds until the quota window resets.
schema:
type: integer
'502':
description: Normalized error with code upstream_unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'503':
description: Normalized error with code degraded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
/v1/webcontext/map:
get:
operationId: webcontext_map
summary: Discover URLs belonging to a site
description: Discover URLs belonging to a site without extracting page content. Results are deduplicated.
tags:
- webcontext
parameters:
- name: url
in: query
required: true
description: Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.
schema:
type: string
format: uri
security:
- bearerAuth: []
responses:
'200':
description: Success response.
headers:
X-Request-Id:
description: Correlation identifier echoed as meta.request_id.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WebContextMapResponse'
'400':
description: Normalized error with code invalid_request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'429':
description: Normalized error with code rate_limited.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
headers:
Retry-After:
description: Seconds until the quota window resets.
schema:
type: integer
'502':
description: Normalized error with code upstream_unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'503':
description: Normalized error with code degraded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
/v1/webcontext/brand:
get:
operationId: webcontext_brand
summary: Extract public brand identity for a site
description: 'Lightweight brand snapshot for one site URL: logos, colors, fonts, and basic public metadata. Prefer brand_retrieve for a fuller normalized brand profile or brand_search for fuzzy company-name discovery.'
tags:
- webcontext
parameters:
- name: url
in: query
required: true
description: Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.
schema:
type: string
format: uri
security:
- bearerAuth: []
responses:
'200':
description: Success response.
headers:
X-Request-Id:
description: Correlation identifier echoed as meta.request_id.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WebContextBrandResponse'
'400':
description: Normalized error with code invalid_request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'429':
description: Normalized error with code rate_limited.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
headers:
Retry-After:
description: Seconds until the quota window resets.
schema:
type: integer
'502':
description: Normalized error with code upstream_unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
'503':
description: Normalized error with code degraded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
components:
schemas:
AnonymousContinuation:
type: object
required:
- url
properties:
url:
type: string
format: uri
const: https://replynodes.com/auth.md
WebContextCrawlResponse:
type: object
properties:
data:
type: object
properties:
url:
type: string
total:
type: integer
completed:
type: integer
errors:
type: integer
pages:
type: array
items:
type: object
properties:
url:
type: string
depth:
type: integer
title:
type:
- string
- 'null'
markdown:
type:
- string
- 'null'
metadata:
$ref: '#/components/schemas/WebContextMetadata'
error:
type: string
additionalProperties: false
required:
- url
- depth
- title
- markdown
- metadata
additionalProperties: false
required:
- url
- total
- completed
- errors
- pages
meta:
$ref: '#/components/schemas/GatewayResponseMeta'
additionalProperties: false
required:
- data
- meta
WebContextMapResponse:
type: object
properties:
data:
type: object
properties:
url:
type: string
count:
type: integer
urls:
type: array
items:
type: string
additionalProperties: false
required:
- url
- count
- urls
meta:
$ref: '#/components/schemas/GatewayResponseMeta'
additionalProperties: false
required:
- data
- meta
ErrorEnvelope:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
request_id:
type: string
retryable:
type: boolean
reason:
type: string
continuation:
$ref: '#/components/schemas/AnonymousContinuation'
status:
type: integer
detail:
type: string
readme:
type: string
next_action:
$ref: '#/components/schemas/NextAction'
additionalProperties: false
required:
- code
- message
- request_id
additionalProperties: false
required:
- error
WebContextScrapeResponse:
type: object
properties:
data:
type: object
properties:
url:
type: string
title:
type:
- string
- 'null'
markdown:
type:
- string
- 'null'
metadata:
$ref: '#/components/schemas/WebContextMetadata'
links:
type: array
items:
type: string
images:
type: array
items:
type: string
truncated:
type: boolean
markdown_chars:
type: integer
additionalProperties: false
required:
- url
- title
- markdown
- metadata
- links
- images
- truncated
- markdown_chars
meta:
$ref: '#/components/schemas/GatewayResponseMeta'
additionalProperties: false
required:
- data
- meta
WebContextBrandResponse:
type: object
properties:
data:
type: object
properties:
url:
type: string
brand:
type: object
properties:
name:
type:
- string
- 'null'
logo_url:
type:
- string
- 'null'
logos:
type:
- array
- 'null'
items:
type: object
properties:
kind:
type: string
url:
type: string
additionalProperties: false
required:
- kind
- url
colors:
type:
- array
- 'null'
items:
type: object
properties:
hex:
type: string
usage:
type: string
count:
type: integer
additionalProperties: false
required:
- hex
- usage
- count
fonts:
type:
- array
- 'null'
items:
type: string
favicon_url:
type:
- string
- 'null'
og_image:
type:
- string
- 'null'
additionalProperties: false
required:
- name
- logo_url
- logos
- colors
- fonts
- favicon_url
- og_image
additionalProperties: false
required:
- url
- brand
meta:
$ref: '#/components/schemas/GatewayResponseMeta'
additionalProperties: false
required:
- data
- meta
NextAction:
type: object
description: Typed next step for an agent (ADR 0024). Present only where a next step exists; branch on action, never on message text.
required:
- action
- method
- url
- required_fields
- docs
properties:
action:
type: string
enum:
- get_api_key
- verify_email
- resend_code
- renew_key
- top_up
- retry_later
description: Closed set; values may be added, never renamed or removed.
method:
type: string
enum:
- GET
- POST
url:
type: string
format: uri
required_fields:
type: array
items:
type: string
optional_fields:
type: array
items:
type: string
human_message:
type: string
description: Short sentence the agent can show its human.
docs:
type: string
format: uri
retry_after_seconds:
type: integer
minimum: 1
description: When the same request may be retried without completing the action.
auth:
type: string
enum:
- bearer_api_key
description: Credential the call needs; bearer_api_key means send the same API key as a Bearer token.
additionalProperties: false
GatewayResponseMeta:
type: object
required:
- request_id
properties:
request_id:
type: string
contract_version:
type: string
generated_at:
type: string
format: date-time
availability:
type: string
detail:
type: string
missing_fields:
type: array
items:
type: string
next_cursor:
type: string
stale:
type: boolean
additionalProperties: false
WebContextMetadata:
type: object
properties:
title:
type:
- string
- 'null'
description:
type:
- string
- 'null'
author:
type:
- string
- 'null'
image:
type:
- string
- 'null'
favicon:
type:
- string
- 'null'
language:
type:
- string
- 'null'
published_date:
type:
- string
- 'null'
site_name:
type:
- string
- 'null'
url:
type:
- string
- 'null'
word_count:
type:
- integer
- 'null'
additionalProperties: false
required:
- title
- description
- author
- image
- favicon
- language
- published_date
- site_name
- word_count
- url
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: rn_test_<64hex> or rn_live_<64hex>
description: API key. Paste the raw key only (e.g. rn_test_...) — the "Bearer " prefix is added automatically.