EdgeChat Resolve API

The Resolve API from EdgeChat — 1 operation(s) for resolve.

GitHub OpenAPI

Operations 2

GET /resolve The article a name most likely means #
POST /resolve Up to 50 names at once, each one request #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/edgechat-ai:edgechat-ai-resolve-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

edgechat-ai-resolve-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Edgepedia Resolve API
  version: '1'
  description: Read-only JSON access to the Edgepedia encyclopedia articles. Keyless. 600 requests a minute and 100,000 a day per IP address (429 with Retry-After past that). Free with credit under the Edgepedia Community License 1.0; AI training is open to everyone.
  license:
    name: Edgepedia Community License 1.0
    url: https://www.edgechat.ai/edgepedia/license
  contact:
    url: https://www.edgechat.ai/developers
    name: EdgeChat
    email: olivia.jin@biostate.ai
  x-logo:
    url: https://www.edgechat.ai/assets/edgechat-chestnut-orange-logo-v2.png
    altText: EdgeChat
    backgroundColor: '#FFFFFF'
    href: https://www.edgechat.ai/developers
  x-origin:
  - format: openapi
    version: '3.1'
    url: https://www.edgechat.ai/openapi.json
servers:
- url: https://www.edgechat.ai/api/v1
tags:
- name: Resolve
paths:
  /resolve:
    get:
      operationId: resolve
      summary: The article a name most likely means
      parameters:
      - name: name
        in: query
        required: true
        description: The name
        schema:
          type: string
        example: Mercury
      - name: context
        in: query
        required: false
        description: Words around the name
        schema:
          type: string
        example: planet
      - name: type
        in: query
        required: false
        description: 'A topic id: candidates under it only'
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: 1 to 10 (default 5)
        schema:
          type: integer
      - $ref: '#/components/parameters/fields'
      responses:
        '200':
          description: The resolution
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Resolution'
              examples:
                live:
                  summary: GET https://www.edgechat.ai/api/v1/resolve?name=Mercury&context=planet
                  description: 'A live answer of 2026-10-07: arrays cut to two items, long text cut with an ellipsis.'
                  value:
                    query: Mercury
                    match: exact
                    confidence: 0.691
                    ambiguous: false
                    result:
                      id: epypvbz0rk
                      slug: mercury-epypvbz0rk
                      title: Mercury
                      match: exact
                      confidence: 0.691
                      excerpt: Mercury most commonly refers to the planet Mercury, the liquid metallic element, and the Roman god, with many other uses in science, business, and sport.
                      topic_path:
                      - id: physical
                        label: Physical world and mathematics
                      - id: physical.science
                        label: General science and scientific practice
                      importance: 4.19991e-07
                      rank: 359345
                      url: https://www.edgechat.ai/mercury-epypvbz0rk
                      api_url: https://www.edgechat.ai/api/v1/articles/mercury-epypvbz0rk
                    alternatives:
                    - id: epg4w2abqm
                      slug: mercury-planet
                      title: Mercury (planet)
                      match: exact
                      confidence: 0.292
                      excerpt: Mercury is the smallest planet and the closest to the Sun, a cratered rocky world that orbits in 88 days and swings from −170 to 420 °C.
                      topic_path:
                      - id: physical
                        label: Physical world and mathematics
                      - id: physical.astronomy
                        label: Astronomy
                      importance: 4.19991e-07
                      rank: 272507
                      url: https://www.edgechat.ai/mercury-planet
                      api_url: https://www.edgechat.ai/api/v1/articles/mercury-planet
                    - id: ep7mtabkh8
                      slug: planet
                      title: Planet
                      match: partial
                      confidence: 0.005
                      excerpt: A planet is a large, rounded astronomical body orbiting a star or stellar remnant. Under the IAU's 2006 definition, the Solar System has eight planets, Mercury through Neptune.
                      topic_path:
                      - id: physical
                        label: Physical world and mathematics
                      - id: physical.astronomy
                        label: Astronomy
                      importance: 4.19991e-07
                      rank: 222251
                      url: https://www.edgechat.ai/planet
                      api_url: https://www.edgechat.ai/api/v1/articles/planet
                    license:
                      name: Edgepedia Community License 1.0
                      url: https://www.edgechat.ai/edgepedia/license
                      summary: Free with credit, commercial use included. AI training is open to everyone. For other uses, organizations over USD 100M in revenue or 100M monthly users license separately.
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/Last-Modified'
            Content-Digest:
              $ref: '#/components/headers/Content-Digest'
            Edgepedia-Corpus-Version:
              $ref: '#/components/headers/Edgepedia-Corpus-Version'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            Retry-After:
              description: Seconds to wait before the next request.
              schema:
                type: integer
      tags:
      - Resolve
    post:
      operationId: resolveBatch
      summary: Up to 50 names at once, each one request
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                queries:
                  type: array
                  maxItems: 50
                  items:
                    type: object
                    required:
                    - name
                    properties:
                      name:
                        type: string
                      context:
                        type: string
                      type:
                        type: string
                      limit:
                        type: integer
                names:
                  type: array
                  maxItems: 50
                  items:
                    type: string
            example:
              names:
              - Paris
              - Koala
      responses:
        '200':
          description: One resolution per name, in order
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveBatchResponse'
              examples:
                live:
                  summary: POST https://www.edgechat.ai/api/v1/resolve
                  description: 'A live answer of 2026-10-07: arrays cut to two items, long text cut with an ellipsis.'
                  value:
                    results:
                    - query: Paris
                      match: exact
                      confidence: 0.925
                      ambiguous: false
                      result:
                        id: ephh5nab68
                        slug: paris-ephh5nab68
                        title: Paris
                        match: exact
                        confidence: 0.925
                        excerpt: Paris, nicknamed the City of Light, is the capital and largest city of France, on the river Seine in the Île-de-France region, with a metropolitan population of 13.2 million.
                        topic_path:
                        - id: places
                          label: Places and geography
                        - id: places.settlements
                          label: Settlements and neighborhoods
                        importance: 4.19991e-07
                        rank: 280795
                        url: https://www.edgechat.ai/paris-ephh5nab68
                        api_url: https://www.edgechat.ai/api/v1/articles/paris-ephh5nab68
                      alternatives:
                      - id: epj48dn5be
                        slug: university-of-paris
                        title: University of Paris
                        match: partial
                        confidence: 0.017
                        excerpt: The University of Paris, known as the Sorbonne, was France's leading university from 1150 to 1970, Europe's second-oldest, chartered in 1200 and divided into 13 universities in 1970.
                        topic_path:
                        - id: society
                          label: Society and history
                        - id: society.education
                          label: Education and knowledge institutions
                        importance: 0.000240902
                        rank: 304
                        url: https://www.edgechat.ai/university-of-paris
                        api_url: https://www.edgechat.ai/api/v1/articles/university-of-paris
                      - id: epqpjx3han
                        slug: paris-agreement
                        title: Paris Agreement
                        match: partial
                        confidence: 0.011
                        excerpt: The Paris Agreement, also known as the Accord de Paris, is an international climate change treaty adopted at COP21 in Paris in 2015, with 194 parties.
                        topic_path:
                        - id: society
                          label: Society and history
                        - id: society.law
                          label: Law and justice
                        importance: 0.000118078
                        rank: 941
                        url: https://www.edgechat.ai/paris-agreement
                        api_url: https://www.edgechat.ai/api/v1/articles/paris-agreement
                    - query: Koala
                      match: exact
                      confidence: 0.988
                      ambiguous: false
                      result:
                        id: ep7rbwcy0a
                        slug: koala
                        title: Koala
                        match: exact
                        confidence: 0.988
                        excerpt: The koala (Phascolarctos cinereus), sometimes inaccurately called the koala bear, is an arboreal herbivorous marsupial native to eastern and southern Australia that eats almost nothing but eucalypt leaves.
                        topic_path:
                        - id: life
                          label: Life and health
                        - id: life.animals
                          label: Animals
                        importance: 4.19991e-07
                        rank: 222907
                        url: https://www.edgechat.ai/koala
                        api_url: https://www.edgechat.ai/api/v1/articles/koala
                      alternatives:
                      - id: epxxn3ztv8
                        slug: koala-man
                        title: Koala Man
                        match: partial
                        confidence: 0.012
                        excerpt: Koala Man is a 2023 American-Australian adult animated superhero sitcom created by Michael Cusack for Hulu, starring Cusack, Sarah Snook, and Hugh Jackman in eight episodes.
                        topic_path:
                        - id: culture
                          label: Arts, language, and belief
                        - id: culture.performance
                          label: Screen, stage, and public media
                        importance: 4.77676e-07
                        rank: 159570
                        url: https://www.edgechat.ai/koala-man
                        api_url: https://www.edgechat.ai/api/v1/articles/koala-man
                    license:
                      name: Edgepedia Community License 1.0
                      url: https://www.edgechat.ai/edgepedia/license
                      summary: Free with credit, commercial use included. AI training is open to everyone. For other uses, organizations over USD 100M in revenue or 100M monthly users license separately.
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/Last-Modified'
            Content-Digest:
              $ref: '#/components/headers/Content-Digest'
            Edgepedia-Corpus-Version:
              $ref: '#/components/headers/Edgepedia-Corpus-Version'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            Retry-After:
              description: Seconds to wait before the next request.
              schema:
                type: integer
      tags:
      - Resolve
components:
  headers:
    RateLimit-Policy:
      description: 'The limiter''s two windows, per IP address and per server instance (IETF RateLimit header fields): 600 requests a minute and 100,000 a day.'
      schema:
        type: string
        example: '"minute";q=600;w=60, "day";q=100000;w=86400'
    RateLimit:
      description: 'On a 429 only: the window that was exceeded, no requests remaining (r=0), and the seconds until it resets (t).'
      schema:
        type: string
        example: '"minute";r=0;t=42'
    Content-Digest:
      description: sha-256 of the body (RFC 9530).
      schema:
        type: string
    Edgepedia-Corpus-Version:
      description: The corpus release that answered.
      schema:
        type: string
    Last-Modified:
      description: The corpus release date (informational; only the ETag validates).
      schema:
        type: string
    ETag:
      description: A hash of the body; send it back as If-None-Match for a 304.
      schema:
        type: string
  schemas:
    Resolution:
      type: object
      properties:
        query:
          type: string
        match:
          type: string
          enum:
          - exact
          - alias
          - anchor
          - partial
          - none
        confidence:
          type: number
        ambiguous:
          type: boolean
        result:
          oneOf:
          - $ref: '#/components/schemas/Candidate'
          - type: 'null'
        alternatives:
          type: array
          items:
            $ref: '#/components/schemas/Candidate'
        license:
          type: object
          properties:
            name:
              type: string
            url:
              type: string
            summary:
              type: string
          required:
          - name
          - url
          - summary
    ArticleRef:
      type: object
      properties:
        id:
          type: string
        slug:
          type: string
        title:
          type: string
        url:
          type: string
        api_url:
          type: string
        importance:
          type: number
        rank:
          type: integer
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            hint:
              type: string
            next:
              type: string
              format: uri
            did_you_mean:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  slug:
                    type: string
                  title:
                    type: string
                  api_url:
                    type: string
          required:
          - code
          - message
      required:
      - error
    ResolveBatchResponse:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/Resolution'
        license:
          type: object
    Candidate:
      allOf:
      - $ref: '#/components/schemas/ArticleRef'
      - type: object
        properties:
          match:
            type: string
            enum:
            - exact
            - alias
            - anchor
            - partial
          confidence:
            type: number
          excerpt:
            type: string
          topic_path:
            type: array
            items:
              type: object
              properties:
                id:
                  type: string
                label:
                  type: string
  parameters:
    fields:
      name: fields
      in: query
      required: false
      description: 'Comma-separated keys: each result (or the answer, when it has no results) keeps only these.'
      schema:
        type: string