Eorzea Market Note Eorzea Market Note

EorzeaMarketNote Web API

Overview

Have you ever wanted to do something with the data from the Eorzea Market Note?

Released the EorzeaMarketNote Web API that supports User Generated Content such as website and application.

It is a simple and powerful one API to offer.

Return the following information for all items at once. The acquisition unit is the world or the data center.

For the meaning of each value, See Glossary.

Primise / Request

EorzeaMarketNote Web API is based on data registered in the EorzeaMarketNote application.

Please cooperate in promoting the application for active data collection.

Please be sure to paste the link to this website when using it on the public website / application.

Endpoint

Request

The parameters of the request are as follows.

Specify the target data center. Target all the worlds belonging to the data center.

Ex. dc=Mana

Specify the target world.

Ex. world=Mandragora


Either dc or world must be specified. If both are specified, it overrides the world.

Response

Success

If acquisition is successful, it returns a response in application json format with HTTP status 200.

If the HTTP status is not 200 or not JSON format, it is regarded as a failure.

Data update frequency and Cache-Control

The data returned by the API is updated regulaly (Currently it is once a day).

It returns the following response HTTP header according to the update time.

Cache-Control: max-age=<seconds>
Last-Modified: <aggregate date>

Please cache with Cache-Control to avoid unnecessary requests to the server. This is a request to reduce the access load of the server.

Last-Modified represents the aggregate date. The format is RFC 2822. This value can be used to determine the data update.

Web application and Access-Control-Allow-Origin

Returns the following response HTTP header so that it can accept requests from JavaScript etc. running on Web application.

Access-Control-Allow-Origin: *

Please do not forget the cache by Cache-Control.

Body part JSON format

The JSON format of the body part is as follow.

{
  "Worldname":{
    "l":{
      "Item key":[NQ Price,HQ Price,NQ Stock,HQ Stock,NQ Circulation(pieces),HQ Circulation(pieces),NQ circulation(unit hour),HQ circulation(unit hour),Researched time],
      "Item key":[NQ Price,HQ Price,NQ Stock,HQ Stock,NQ Circulation(pieces),HQ Circulation(pieces),NQ circulation(unit hour),HQ circulation(unit hour),Researched time],
      ...
    },
    "o":{
      "Item key":[Material cost(HQ First),Material cost(Price First)],
      "Item key":[Material cost(HQ First),Material cost(Price First)],
      ...
    }
  },
  "Worldname":{
    ...
  },
  ...
}

The item key is equivalent to the key in the official URL "Eorzea Database".

An example of the potion is as follows.

The type of price / stock is an integer. If it is not researched, it becomes null value.

The researched time is UNIX epoch.

Implementation examples

Disclaimer

Please acknowledge that this service may change / temporarily or permanently stop without notice.

Please use at your own risk.