Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/frase-io:frase-io-serp-api"
All apis
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.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Frase SERP API
version: 1.0.0
description: 'The Frase API provides programmatic access to your SEO content platform. Use it to manage content, research, audits, AI visibility tracking, and more. ## Authentication
All API requests require authentication using an API key. Include your key in the `X-API-KEY` header:
```
X-API-KEY: sk_live_your_api_key_here
```
For legacy compatibility, the `token` header is also supported. ## Rate Limits
Three independent limits apply, each with its own headers and error code. Headers are returned on `429` responses, not on successful ones. **Per-minute burst** - 60/min on trial and Starter, 120 Professional, 300 Scale, 1,000 Enterprise. Error code `rate_limit_exceeded`. - `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (epoch seconds)
**Sustained hourly ceiling** - 2,000/hour trial, 3,000 Starter, 5,000 Professional, 15,000 Scale, 50,000 Enterprise. Error code `hourly_limit_exceeded`. - `X-RateLimit-Hourly-Limit`, `X-RateLimit-Hourly-Remaining`, `X-RateLimit-Hourly-Reset` (epoch seconds)
**Monthly request budget** - error code `monthly_budget_exceeded`, headers `X-Monthly-Limit`, `X-Monthly-Used`, `X-Monthly-Remaining`. Every `429` carries `Retry-After` in seconds. On the hourly ceiling this can be up to 3,600, so clients should honour it rather than retrying on a short fixed backoff - a retry sooner than `Retry-After` cannot succeed. ## Errors
The API uses standard HTTP status codes and returns errors in a consistent format:
```json
{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API key provided.",
"doc_url": "https://docs.frase.io/api/errors#invalid_api_key"
}
}
```
## Changelog
Breaking changes are listed here, newest first. "Breaking" means a field that was always present with a value can now be `null`, or an existing value now means something different — not that a field was removed or renamed. Additive fields are not listed. ### 2026-08-31 — Fact `sources[]` may omit `url`, and minted facts default to `approved`
- `GET /briefs/{id}/facts`, `PATCH /briefs/{id}/facts/{factId}` → a `sources[]` entry may now carry only `title`, with no `url` or `domain`. Research names a publisher far more often than it captures a link (793 of 801 plan-evidence items in production), and those names were previously discarded rather than returned. Read `url` defensively. - `GET /briefs/{id}/facts` → `approval` on a newly minted fact is now `approved` rather than `pending`. A client polling for `pending` facts to review will see far fewer; rejection is unchanged and remains permanent. Facts the writer asserted in its own output (`provenance: generated`) are still minted `pending`. ### 2026-08-24 — Content Guard''s hasPublishedUrl is now recoverability, not the stored URL
- `GET /content/{id}/monitoring` → `hasPublishedUrl`: was a judgment on the STORED URL (false for a relative path even when the page was live). It now answers "could Guard watch this article right now" — the stored URL when absolute, or an address the server recovers (CMS inventory; FraseCMS re-derivation from current settings when a live published post exists). `true` no longer implies the stored URL itself is absolute, and a FraseCMS article published before domain setup flips to `true` when setup finishes, with no re-publish. It remains exactly the condition enabling enforces. - `publishedUrlIssue` is now the RESIDUAL after recovery failed, not a raw-column classification — "not_absolute" can also mean the FraseCMS post is not live or FraseCMS is disabled for the site. - `POST /content/{id}/publish` → `url` (frase_cms): now derived from the site''s current CMS settings rather than the adapter''s host-of-the-moment value; the same URL is stored on the content row and sent in the content.published webhook.'
contact:
name: Frase Support
url: https://frase.io
email: support@frase.io
license:
name: Proprietary
url: https://www.frase.io/company/terms
servers:
- url: https://next.frase.io/api/v1
description: Production
- url: /api/v1
description: This host
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: SERP
description: SERP analysis and competitor research
paths:
/serp/analyze:
post:
operationId: analyzeSERP
summary: Analyze SERP
description: Analyze search results for a keyword, including AI Overview and PAA.
tags:
- SERP
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- keyword
properties:
keyword:
type: string
minLength: 2
maxLength: 200
location:
type: string
default: United States
country_code:
type: string
default: us
language_code:
type: string
default: en
num:
type: integer
default: 10
maximum: 20
minimum: 5
description: Number of SERP results to fetch
responses:
'200':
description: SERP analysis
content:
application/json:
schema:
$ref: '#/components/schemas/SERPAnalysis'
'429':
$ref: '#/components/responses/RateLimited'
/serp/competitors:
post:
operationId: analyzeCompetitors
summary: Analyze competitors
description: Compare a URL against SERP competitors for a keyword.
tags:
- SERP
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- keyword
- url
properties:
keyword:
type: string
url:
type: string
format: uri
location:
type: string
country_code:
type: string
language_code:
type: string
responses:
'200':
description: Competitor analysis
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
keyword:
type: string
target_url:
type: string
target_domain:
type: string
search_parameters:
type: object
target_visibility:
type: object
properties:
is_ranking:
type: boolean
position:
type: integer
nullable: true
title:
type: string
nullable: true
snippet:
type: string
nullable: true
competitive_analysis:
type: object
properties:
total_competitors:
type: integer
competitors:
type: array
items:
type: object
opportunities:
type: object
request_id:
type: string
'429':
$ref: '#/components/responses/RateLimited'
/serp/intent:
post:
operationId: classifyIntent
summary: Classify search intent
description: Classify the search intent for a keyword.
tags:
- SERP
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- keyword
properties:
keyword:
type: string
responses:
'200':
description: Intent classification
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
keyword:
type: string
search_parameters:
type: object
intent_classification:
type: object
properties:
primary_intent:
type: string
confidence:
type: number
scores:
type: object
properties:
informational:
type: number
navigational:
type: number
transactional:
type: number
commercial:
type: number
serp_signals:
type: object
recommendations:
type: array
items:
type: string
content_type_suggestions:
type: array
items:
type: string
request_id:
type: string
'429':
$ref: '#/components/responses/RateLimited'
components:
schemas:
SERPAnalysis:
type: object
properties:
keyword:
type: string
search_parameters:
type: object
properties:
location:
type: string
country_code:
type: string
language_code:
type: string
num_results:
type: integer
search_info:
type: object
properties:
total_results:
type: integer
nullable: true
time_taken:
type: number
nullable: true
ai_overview:
type: object
nullable: true
properties:
text:
type: string
sources:
type: array
items:
type: object
properties:
title:
type: string
url:
type: string
snippet:
type: string
nullable: true
organic_results:
type: array
items:
type: object
properties:
position:
type: integer
title:
type: string
url:
type: string
snippet:
type: string
people_also_ask:
type: array
items:
type: object
properties:
position:
type: integer
question:
type: string
snippet:
type: string
nullable: true
source_url:
type: string
nullable: true
related_searches:
type: array
items:
type: string
Error:
type: object
properties:
error:
type: object
properties:
type:
type: string
code:
type: string
message:
type: string
param:
type: string
doc_url:
type: string
request_id:
type: string
responses:
RateLimited:
description: Rate limit exceeded
headers:
Retry-After:
schema:
type: integer
description: Seconds until rate limit resets
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
type: rate_limit_error
code: rate_limit_exceeded
message: Rate limit exceeded. Please retry after 60 seconds.
doc_url: https://docs.frase.io/api/errors#rate_limit_exceeded
request_id: req_abc123
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-KEY
description: 'API key for authentication. Get your key from Settings > API Keys. You may also send the same key as `Authorization: Bearer <key>` — see BearerAuth.'
BearerAuth:
type: http
scheme: bearer
bearerFormat: Frase API key (sk_live_* / sk_test_*) or MCP access token (mcp_at_*)
description: 'Send either your API key or an MCP access token as `Authorization: Bearer <token>`. An API key sent this way is exactly equivalent to sending it in X-API-KEY — same identity, same scopes, same rate limits — so use whichever your HTTP client makes natural. X-API-KEY takes precedence if you somehow send both. Cookie/session auth is intentionally NOT supported on /api/v1/* endpoints.'