Semrush · OpenAPI Overlay 1.0.0

Semrush Hermes Partner API — API Evangelist enhancements

6 actions 6 updates documentation extends ../openapi/semrush-hermes-partner-api-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Semrush's API. It is a proposal applied on top of the contract, not a document Semrush publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

operationIdx-operation-id-sourcecontacttermsOfServicex-upstream-sourcex-upstream-titlex-providerx-provider-id

Targets 6

$.info
$
$.paths['/apis/v4/hermes/v0/subscriptions'].get
$.paths['/apis/v4/hermes/v0/user/{user_id}/subscription/{id}'].get
$.paths['/apis/v4/hermes/v0/event'].post
$.paths['/apis/v4/hermes/v0/event/{id}'].get

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: Semrush Hermes Partner API — API Evangelist enhancements
  version: 1.0.0
x-generated: '2026-08-13'
x-method: generated
x-source: >-
  Derived from https://developer.semrush.com/api/v4/ and
  https://github.com/semrush/app-center-openapi. Applies to
  openapi/semrush-hermes-partner-api-api-openapi.yml. The original spec is never mutated.
extends: ../openapi/semrush-hermes-partner-api-api-openapi.yml
actions:
- target: $.info
  description: Attach provenance, contact and external documentation the upstream spec omits.
  update:
    contact:
      name: Semrush API Support
      email: mail@semrush.com
      url: https://developer.semrush.com/api/
    termsOfService: https://www.semrush.com/company/legal/terms-of-service/
    x-upstream-source: https://github.com/semrush/app-center-openapi/blob/main/openapi_spec.yaml
    x-upstream-title: Semrush AppCenter API
    x-provider: Semrush
    x-provider-id: semrush
- target: $
  description: >-
    Add external documentation and declare the runtime semantics that live only in prose on
    the Semrush developer portal.
  update:
    externalDocs:
      description: Semrush API documentation
      url: https://developer.semrush.com/api/v4/
    x-rate-limits:
      requests_per_second: 10
      concurrent_requests: 10
      scope: account
      response_headers: none
      source: https://developer.semrush.com/api/v4/introduction/api-usage-restrictions/
    x-error-envelope:
      shape: 'meta{success,status_code,request_id} + (data|error)'
      rfc9457: false
      artifact: errors/semrush-problem-types.yml
    x-idempotency:
      supported: false
      note: No idempotency key is documented for any Semrush write operation.
    x-caching-restriction: >-
      Terms of Service section 3.3 forbids caching API-derived information for more than one
      month without express written consent.
- target: $.paths['/apis/v4/hermes/v0/subscriptions'].get
  description: Add a stable operationId — the upstream spec declares none anywhere.
  update:
    operationId: getHermesSubscriptions
    x-operation-id-source: api-evangelist-overlay
- target: $.paths['/apis/v4/hermes/v0/user/{user_id}/subscription/{id}'].get
  description: Add a stable operationId.
  update:
    operationId: getHermesUserSubscriptionStatus
    x-operation-id-source: api-evangelist-overlay
- target: $.paths['/apis/v4/hermes/v0/event'].post
  description: Add a stable operationId and flag the write consequence.
  update:
    operationId: createHermesEvent
    x-operation-id-source: api-evangelist-overlay
    x-consequence: write
    x-safe-to-retry: false
- target: $.paths['/apis/v4/hermes/v0/event/{id}'].get
  description: Add a stable operationId.
  update:
    operationId: getHermesEventStatus
    x-operation-id-source: api-evangelist-overlay

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • 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.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/semrush-hermes-partner-api-api-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.