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/myoddly-com:myoddly-com-benchmarks-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. 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: Oddly Platform Benchmarks API
version: 1.0.0
description: 'Programmatic access to oddly''s deterministic commerce primitives for agents, automations, and partner tools. Authenticate with a bearer key minted at /dashboard/developers. Receipts are the rail: every response is traceable to the exact rule that produced it, so an answer is auditable, cacheable, and reproducible. All v1 endpoints are deterministic: same inputs, same outputs, no model in the hot path.'
servers:
- url: https://myoddly.com
security:
- bearerAuth: []
tags:
- name: Benchmarks
description: Cross-tenant cohort benchmarks.
paths:
/api/v1/benchmarks:
get:
operationId: listBenchmarks
tags:
- Benchmarks
summary: List cross-tenant cohort benchmarks
description: 'Privacy-floored: cohorts below 5 contributing clients over the week are excluded. Spark tier and up.'
parameters:
- name: industry
in: query
required: false
schema:
type: string
- name: spend_bucket
in: query
required: false
schema:
type: string
enum:
- 0-1k
- 1-5k
- 5-10k
- 10-25k
- 25-50k
- 50k+
- name: week
in: query
required: false
description: ISO week start (YYYY-MM-DD). Defaults to the most recent published week.
schema:
type: string
format: date
- name: cursor
in: query
required: false
description: Opaque pagination cursor from a previous response's meta.next_cursor.
schema:
type: string
- name: limit
in: query
required: false
description: Page size. Default 25, max 100.
schema:
type: integer
minimum: 1
maximum: 100
default: 25
responses:
'200':
description: Benchmark cohorts.
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
'400':
description: Invalid request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication failed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Tier upgrade required.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- type
- code
- message
- request_id
properties:
type:
type: string
enum:
- invalid_request
- auth_invalid
- tier_required
- not_found
- rate_limited
- server_error
code:
type: string
message:
type: string
details:
type: object
nullable: true
request_id:
type: string
Envelope:
type: object
required:
- data
- meta
properties:
data:
type: object
description: The resource payload. Shape depends on the endpoint.
meta:
$ref: '#/components/schemas/Meta'
Meta:
type: object
required:
- request_id
- api_version
- tier
properties:
request_id:
type: string
description: Echoed in the X-Request-Id header. Quote it in support tickets.
api_version:
type: string
enum:
- v1
tier:
type: string
description: The caller's tier at request time.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: oddly_live_*
description: 'API key minted at /dashboard/developers. Send as: Authorization: Bearer oddly_live_...'