FetchRight API Documentation
Complete REST API reference for accessing content through the FetchRight platform. This API enables AI agents and applications to respectfully access publisher content according to peek.json policies.
🚀 Quick Start
Get started with the FetchRight API in minutes. All you need is an API key and a URL to peek.json protected content.
https://api.fetchright.ai/v2/peek \
-d “url=https://example.com/article”
Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header using the Bearer token format.
Getting an API Key
- Sign up for a FetchRight account at
https://dashboard.fetchright.ai - Navigate to the API Keys section in your dashboard
- Generate a new API key with appropriate permissions
- Securely store your API key (it won’t be shown again)
Authentication Header
⚠️ Security Note: Never expose your API key in client-side code or public repositories. Use environment variables or secure key management systems.
Base URL
All API endpoints are relative to the base URL:
Core Endpoints
POST /peek
Retrieve basic information about a resource according to its peek.json policy. This endpoint typically provides free access to metadata, headlines, and abstracts.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | URL of the content to peek |
| format | string | No | Response format: “json” or “html” (default: json) |
Example Request
Content-Type: application/json
Authorization: Bearer abc123xyz
{ "url": "https://example.com/article/ai-breakthrough-2025", "format": "json" }
Example Response
POST /summarize
Generate an AI summary of the content according to the resource’s pricing policy. Costs vary by publisher and content type.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | URL of the content to summarize |
| length | string | No | “short”, “medium”, or “long” (default: medium) |
| focus | string | No | Specific aspect to focus on in summary |
POST /quote
Extract and quote specific passages from content with proper attribution. Useful for research and content creation while respecting copyright.
POST /read
Access full content when permitted by the publisher’s peek.json policy. Requires appropriate licensing for most premium content.
Rate Limits
API requests are subject to rate limits to ensure fair usage and system stability:
- Free Tier: 100 requests per hour, 1,000 requests per day
- Pro Tier: 1,000 requests per hour, 25,000 requests per day
- Enterprise: Custom limits based on agreement
Rate limit information is included in response headers:
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1693123200
Error Handling
The API uses standard HTTP status codes and returns detailed error information in JSON format.
Common Error Codes
| Status Code | Meaning | Description |
|---|---|---|
| 400 | Bad Request | Invalid request parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 403 | Forbidden | Operation not allowed by content policy |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Unexpected server error |
Error Response Format
SDKs and Libraries
Official SDKs are available for popular programming languages:
- JavaScript/Node.js:
npm install @fetchright/sdk - Python:
pip install fetchright-sdk - Go:
go get github.com/fetchright/go-sdk - Ruby:
gem install fetchright
JavaScript Example
const client = new FetchRight(“your-api-key”)
const result = await client.peek(
“https://example.com/article”
)
console.log(result.title)
Support
Need help with the API? We’re here to assist:
- 📧 Email: api-support@fetchright.ai
- 💬 Discord: Join our developer community
- 📖 Docs: https://docs.fetchright.ai
- 🐛 Issues: https://github.com/fetchright/api-issues