EVE Online

EVE Online Search API

The Search API from EVE Online — 2 operation(s) for search.

GitHub OpenAPI

Operations 2

Documentation

📖
Documentation
https://developers.eveonline.com/docs/services/esi/
📖
BestPractices
https://developers.eveonline.com/docs/services/esi/best-practices/
📖
RateLimits
https://developers.eveonline.com/docs/services/esi/rate-limiting/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/eve-online/refs/heads/main/openapi/eve-online-search-api-openapi.yml

Other Resources

🔗
APIExplorer
https://developers.eveonline.com/api-explorer
🔗
Swagger
https://esi.evetech.net/ui
🔗
GitHubRepo
https://github.com/esi/esi-docs
🔗
GitHubRepo
https://github.com/esi/esi-issues
🔗
GitHubRepo
https://github.com/esi/esi-routes
🔗
GitHubRepo
https://github.com/esi/eve-glue
🔗
SupportIssues
https://github.com/esi/esi-issues

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/eve-online-search-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

OpenAPI Specification

eve-online-search-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Eve Online Search API
  version: '1.36'
  description: 'Operations tagged Search across 7 of this provider''s published API definitions: eve-online-openapi.yml, swagger.json, swagger_2.json, swagger_3.json, swagger_4.json, swagger_5.json, swagger_6.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://esi.evetech.net/latest
- url: https://esi.evetech.net
- url: https://esi.evetech.net/legacy
- url: https://esi.evetech.net/dev
tags:
- name: Search
paths:
  /characters/{character_id}/search/:
    get:
      description: 'Search for entities that match a given sub-string.


        ---

        Alternate route: `/dev/characters/{character_id}/search/`


        Alternate route: `/legacy/characters/{character_id}/search/`


        Alternate route: `/v3/characters/{character_id}/search/`


        ---

        This route is cached for up to 3600 seconds'
      operationId: get_characters_character_id_search
      parameters:
      - $ref: '#/components/parameters/Accept-Language'
      - description: Type of entities to search for
        in: query
        name: categories
        required: true
        style: form
        explode: false
        schema:
          type: array
          items:
            enum:
            - agent
            - alliance
            - character
            - constellation
            - corporation
            - faction
            - inventory_type
            - region
            - solar_system
            - station
            - structure
            type: string
          minItems: 1
          maxItems: 11
          uniqueItems: true
        example:
        - agent
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/language'
      - description: The string to search on
        in: query
        name: search
        required: true
        schema:
          type: string
          minLength: 3
        example: example
      - description: Whether the search should be a strict match
        in: query
        name: strict
        schema:
          type: boolean
          default: false
        example: false
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: A list of search results
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            Content-Language:
              description: The language used in the response
              schema:
                type: string
                enum:
                - en
                - de
                - fr
                - ja
                - ru
                - zh
                - ko
                - es
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  agent:
                    description: agent array
                    items:
                      description: agent integer
                      format: int32
                      title: get_characters_character_id_search_agent_agent
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_agent
                    type: array
                  alliance:
                    description: alliance array
                    items:
                      description: alliance integer
                      format: int32
                      title: get_characters_character_id_search_alliance_alliance
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_alliance
                    type: array
                  character:
                    description: character array
                    items:
                      description: character integer
                      format: int32
                      title: get_characters_character_id_search_character_character
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_character
                    type: array
                  constellation:
                    description: constellation array
                    items:
                      description: constellation integer
                      format: int32
                      title: get_characters_character_id_search_constellation_constellation
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_constellation
                    type: array
                  corporation:
                    description: corporation array
                    items:
                      description: corporation integer
                      format: int32
                      title: get_characters_character_id_search_corporation_corporation
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_corporation
                    type: array
                  faction:
                    description: faction array
                    items:
                      description: faction integer
                      format: int32
                      title: get_characters_character_id_search_faction_faction
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_faction
                    type: array
                  inventory_type:
                    description: inventory_type array
                    items:
                      description: inventory_type integer
                      format: int32
                      title: get_characters_character_id_search_inventory_type_inventory_type
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_inventory_type
                    type: array
                  region:
                    description: region array
                    items:
                      description: region integer
                      format: int32
                      title: get_characters_character_id_search_region_region
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_region
                    type: array
                  solar_system:
                    description: solar_system array
                    items:
                      description: solar_system integer
                      format: int32
                      title: get_characters_character_id_search_solar_system_solar_system
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_solar_system
                    type: array
                  station:
                    description: station array
                    items:
                      description: station integer
                      format: int32
                      title: get_characters_character_id_search_station_station
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_station
                    type: array
                  structure:
                    description: structure array
                    items:
                      description: structure integer
                      format: int64
                      title: get_characters_character_id_search_structure_structure
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_structure
                    type: array
                title: get_characters_character_id_search_ok
                type: object
              examples:
                response:
                  value:
                    solar_system:
                    - 30002510
                    station:
                    - 60004588
                    - 60004594
                    - 60005725
                    - 60009106
                    - 60012721
                    - 60012724
                    - 60012727
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
              examples:
                response:
                  value:
                    error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized'
              examples:
                response:
                  value:
                    error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden'
              examples:
                response:
                  value:
                    error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited'
              examples:
                response:
                  value:
                    error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error'
              examples:
                response:
                  value:
                    error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable'
              examples:
                response:
                  value:
                    error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout'
              examples:
                response:
                  value:
                    error: Gateway timeout message
      security:
      - evesso:
        - esi-search.search_structures.v1
      summary: EVE Online Search on a String
      tags:
      - Search
      x-alternate-versions:
      - dev
      - legacy
      - v3
      x-cached-seconds: 3600
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /v3/characters/{character_id}/search/:
    get:
      description: 'Search for entities that match a given sub-string.


        ---


        This route is cached for up to 3600 seconds'
      operationId: get_characters_character_id_search
      parameters:
      - $ref: '#/components/parameters/Accept-Language'
      - description: Type of entities to search for
        in: query
        name: categories
        required: true
        schema:
          type: array
          items:
            enum:
            - agent
            - alliance
            - character
            - constellation
            - corporation
            - faction
            - inventory_type
            - region
            - solar_system
            - station
            - structure
            type: string
          maxItems: 11
          minItems: 1
          uniqueItems: true
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/language'
      - description: The string to search on
        in: query
        name: search
        required: true
        schema:
          type: string
          minLength: 3
      - description: Whether the search should be a strict match
        in: query
        name: strict
        schema:
          type: boolean
          default: false
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: A list of search results
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            Content-Language:
              description: The language used in the response
              schema:
                type: string
                enum:
                - en
                - de
                - fr
                - ja
                - ru
                - zh
                - ko
                - es
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  agent:
                    description: agent array
                    items:
                      description: agent integer
                      format: int32
                      title: get_characters_character_id_search_agent_agent
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_agent
                    type: array
                  alliance:
                    description: alliance array
                    items:
                      description: alliance integer
                      format: int32
                      title: get_characters_character_id_search_alliance_alliance
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_alliance
                    type: array
                  character:
                    description: character array
                    items:
                      description: character integer
                      format: int32
                      title: get_characters_character_id_search_character_character
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_character
                    type: array
                  constellation:
                    description: constellation array
                    items:
                      description: constellation integer
                      format: int32
                      title: get_characters_character_id_search_constellation_constellation
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_constellation
                    type: array
                  corporation:
                    description: corporation array
                    items:
                      description: corporation integer
                      format: int32
                      title: get_characters_character_id_search_corporation_corporation
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_corporation
                    type: array
                  faction:
                    description: faction array
                    items:
                      description: faction integer
                      format: int32
                      title: get_characters_character_id_search_faction_faction
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_faction
                    type: array
                  inventory_type:
                    description: inventory_type array
                    items:
                      description: inventory_type integer
                      format: int32
                      title: get_characters_character_id_search_inventory_type_inventory_type
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_inventory_type
                    type: array
                  region:
                    description: region array
                    items:
                      description: region integer
                      format: int32
                      title: get_characters_character_id_search_region_region
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_region
                    type: array
                  solar_system:
                    description: solar_system array
                    items:
                      description: solar_system integer
                      format: int32
                      title: get_characters_character_id_search_solar_system_solar_system
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_solar_system
                    type: array
                  station:
                    description: station array
                    items:
                      description: station integer
                      format: int32
                      title: get_characters_character_id_search_station_station
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_station
                    type: array
                  structure:
                    description: structure array
                    items:
                      description: structure integer
                      format: int64
                      title: get_characters_character_id_search_structure_structure
                      type: integer
                    maxItems: 500
                    title: get_characters_character_id_search_structure
                    type: array
                title: get_characters_character_id_search_ok
                type: object
              example:
                solar_system:
                - 30002510
                station:
                - 60004588
                - 60004594
                - 60005725
                - 60009106
                - 60012721
                - 60012724
                - 60012727
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request_2'
              example:
                error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized_2'
              example:
                error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden_2'
              example:
                error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited_2'
              example:
                error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error_2'
              example:
                error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable_2'
              example:
                error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout_2'
              example:
                error: Gateway timeout message
      security:
      - evesso:
        - esi-search.search_structures.v1
      summary: Search on a string
      tags:
      - Search
      x-alternate-versions:
      - latest
      - legacy
      - v3
      x-cached-seconds: 3600
    servers:
    - url: https://esi.evetech.net
components:
  schemas:
    unauthorized:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
          example: example
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
          example: example
      required:
      - error
      title: Service unavailable
      type: object
    error_limited:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
          example: example
      required:
      - error
      title: Error limited
      type: object
    bad_request:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
          example: example
      required:
      - error
      title: Bad request
      type: object
    internal_server_error:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
          example: example
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
          example: example
        timeout:
          description: number of seconds the request was given
          type: integer
          example: 1
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
          example: example
        sso_status:
          description: status code received from SSO
          type: integer
          example: 1
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_2:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable_2:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
      required:
      - error
      title: Service unavailable
      type: object
    error_limited_2:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
      required:
      - error
      title: Error limited
      type: object
    bad_request_2:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
      required:
      - error
      title: Bad request
      type: object
    internal_server_error_2:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout_2:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
        timeout:
          description: number of seconds the request was given
          type: integer
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden_2:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
        sso_status:
          description: status code received from SSO
          type: integer
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_3:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable_3:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
      required:
      - error
      title: Service unavailable
      type: object
    error_limited_3:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
      required:
      - error
      title: Error limited
      type: object
    bad_request_3:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
      required:
      - error
      title: Bad request
      type: object
    internal_server_error_3:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout_3:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
        timeout:
          description: number of seconds the request was given
          type: integer
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden_3:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
        sso_status:
          description: status code received from SSO
          type: integer
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_4:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable_4:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
      required:
      - error
      title: Service unavailable
      type: object
    error_limited_4:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
      required:
      - error
      title: Error limited
      type: object
    bad_request_4:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
      required:
      - error
      title: Bad request
      type: object
    internal_server_error_4:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout_4:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
        timeout:
          description: number of seconds the request was given
          type: integer
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden_4:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
        sso_status:
          description: status code received from SSO
          type: integer
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_5:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable_5:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
      required:
      - error
      title: Service unavailable
      type: object
    error_limited_5:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
      required:
      - error
      title: Error limited
      type: object
    bad_request_5:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
      required:
      - error
      title: Bad request
      type: object
    internal_server_error_5:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout_5:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
        timeout:
          description: number of seconds the request was given
          type: integer
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden_5:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
        sso_status:
          description: status code received from SSO
          type: integer
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_6:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable_6:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: s

# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/eve-online/refs/heads/main/openapi/eve-online-search-api-openapi.yml