epicgamesapi

Epic Games API (Unofficial)

Babak Farkhoopak

Babak Farkhoopak

Life's a garden. Dig it.

Base URL: https://epicgames-api/api.

Endpoints

Products

GET /products

Get a list of all Products.

Query Parameters

search
  • Optional: true
  • Type: string
  • Example: GET https://epicgames-api/api/products?search=Gun

Filter products by using a search query to search for Products by their Title or Description.

minPrice
  • Optional: true
  • Type: number
  • Minimum: 0
  • Example: GET https://epicgames-api/api/products?minPrice=100

Filter products by using a minimum price to search for Products by their Price.

maxPrice
  • Optional: true
  • Type: number
  • Minimum: 0
  • Example: GET https://epicgames-api/api/products?maxPrice=100

Filter products by using a maximum price to search for Products by their Price.

minDiscount
  • Optional: true
  • Type: number
  • Minimum: 0
  • Example: GET https://epicgames-api/api/products?minDiscount=100

Filter products by using a minimum discount to search for Products by their Discount.

maxDiscount
  • Optional: true
  • Type: number
  • Minimum: 0
  • Example: GET https://epicgames-api/api/products?maxDiscount=100

Filter products by using a maximum discount to search for Products by their Discount.

tagIds
  • Optional: true
  • Type: string. Comma-separated list of Tag IDs (IDs with minimum value of 1).
  • Example: GET https://epicgames-api/api/products?tagIds=1,2,3

Filter products by using a comma-separated list of Tag IDs to search for Products by their Tags.

start
  • Optional: true
  • Type: number
  • Default: 0
  • Minimum: 0
  • Example: GET https://epicgames-api/api/products?start=10

Start the search at a specific index.

limit
  • Optional: true
  • Type: number
  • Default: 10
  • Minimum: 1
  • Maximum: 100
  • Example: GET https://epicgames-api/api/products?limit=10

Limit the number of results to be returned.

Response
  • Body: Products
  • Status: 200
Example

GET https://epicgames-api/api/products

[
    {
        "id": 1,
        "slug": "blasphemous-2",
        "title": "Blasphemous 2",
        "description": "The Penitent One awakens as Blasphemous 2 joins him once again in an endless struggle against The Miracle. Dive into a perilous new world filled with mysteries and secrets to discover.",
        "image": {
            "tall": "https://cdn1.epicgames.com/offer/c2890856ddb844f1a7d552fc929838a7/EGS_Blasphemous2_TheGameKitchen_S2_1200x1600-06855277692f2ef37230f8dbc8cf0df7_1200x1600-06855277692f2ef37230f8dbc8cf0df7",
            "wide": "https://cdn1.epicgames.com/offer/c2890856ddb844f1a7d552fc929838a7/EGS_Blasphemous2_TheGameKitchen_S1_2560x1440-12672e8bbe1c508efc9a7c6a871421ec_2560x1440-12672e8bbe1c508efc9a7c6a871421ec"
        },
        "price": 2999,
        "discount": 0,
        "tags": [1, 45, 56, 3, 12, 23]
    }
]
Errors
400 Bad Request
  • Body: string
  • Status: 400
  • Status Text: "Bad Request"

GET /products/id/:id

Get a single Product by ID.

  • Type: number
Response
  • Body: Product
  • Status: 200
Example

GET https://epicgames-api/api/products/id/1

{
    "id": 1,
    "slug": "blasphemous-2",
    "title": "Blasphemous 2",
    "description": "The Penitent One awakens as Blasphemous 2 joins him once again in an endless struggle against The Miracle. Dive into a perilous new world filled with mysteries and secrets to discover.",
    "image": {
        "tall": "https://cdn1.epicgames.com/offer/c2890856ddb844f1a7d552fc929838a7/EGS_Blasphemous2_TheGameKitchen_S2_1200x1600-06855277692f2ef37230f8dbc8cf0df7_1200x1600-06855277692f2ef37230f8dbc8cf0df7",
        "wide": "https://cdn1.epicgames.com/offer/c2890856ddb844f1a7d552fc929838a7/EGS_Blasphemous2_TheGameKitchen_S1_2560x1440-12672e8bbe1c508efc9a7c6a871421ec_2560x1440-12672e8bbe1c508efc9a7c6a871421ec"
    },
    "price": 2999,
    "discount": 0,
    "tags": [1, 45, 56, 3, 12, 23]
}
Errors
404 Not Found
  • Body: "Product Not Found"
  • Status: 404
  • Status Text: "Not Found"
400 Bad Request
  • Body: string
  • Status: 400
  • Status Text: "Bad Request"

GET /products/slug/:slug

  • Type: string

Get a single Product by Slug.

Response
  • Body: Product
  • Status: 200
Example

GET https://epicgames-api/api/products/slug/blasphemous-2

{
    "id": 1,
    "slug": "blasphemous-2",
    "title": "Blasphemous 2",
    "description": "The Penitent One awakens as Blasphemous 2 joins him once again in an endless struggle against The Miracle. Dive into a perilous new world filled with mysteries and secrets to discover.",
    "image": {
        "tall": "https://cdn1.epicgames.com/offer/c2890856ddb844f1a7d552fc929838a7/EGS_Blasphemous2_TheGameKitchen_S2_1200x1600-06855277692f2ef37230f8dbc8cf0df7_1200x1600-06855277692f2ef37230f8dbc8cf0df7",
        "wide": "https://cdn1.epicgames.com/offer/c2890856ddb844f1a7d552fc929838a7/EGS_Blasphemous2_TheGameKitchen_S1_2560x1440-12672e8bbe1c508efc9a7c6a871421ec_2560x1440-12672e8bbe1c508efc9a7c6a871421ec"
    },
    "price": 2999,
    "discount": 0,
    "tags": [1, 45, 56, 3, 12, 23]
}
Errors
404 Not Found
  • Body: "Product Not Found"
  • Status: 404
  • Status Text: "Not Found"
400 Bad Request
  • Body: string
  • Status: 400
  • Status Text: "Bad Request"

Tags

GET /tags

Get a list of all Tags.

Query Parameters

search
  • Optional: true
  • Type: string
  • Example: GET https://epicgames-api/api/tags?search=Action

Filter tags by using a search query to search for Tags by their Name.

groupNames
  • Optional: true
  • Type: string
  • Example: GET https://epicgames-api/api/tags?groupNames=genre,feature,platform

Search for Tags by a spesific group name. Example: "genre", "platform".

Response
  • Body: Tags
  • Status: 200
Example

GET https://epicgames-api/api/tags

[
    {
        "id": 1,
        "name": "Action",
        "slug": "action",
        "groupName": "genre"
    },
    {
        "id": 28,
        "name": "Multiplayer",
        "slug": "multiplayer",
        "groupName": "feature"
    },
    {
        "id": 56,
        "name": "Windows",
        "slug": "windows",
        "groupName": "platform"
    }
]
Errors
400 Bad Request
  • Body: string
  • Status: 400
  • Status Text: "Bad Request"

GET /tags/id/:id

Get a single Tag by ID.

  • Type: number
Response
  • Body: Tag
  • Status: 200
Example

GET https://epicgames-api/api/tags/id/1

{
    "id": 1,
    "name": "Action",
    "slug": "action",
    "groupName": "genre"
}
Errors
404 Not Found
  • Body: "Tag Not Found"
  • Status: 404
  • Status Text: "Not Found"
400 Bad Request
  • Body: string
  • Status: 400
  • Status Text: "Bad Request"

GET /tags/slug/:slug

Get a single Tag by Slug.

  • Type: string
Response
  • Body: Tag
  • Status: 200
Example

GET https://epicgames-api/api/tags/slug/action

{
    "id": 1,
    "name": "Action",
    "slug": "action",
    "groupName": "genre"
}
Errors
404 Not Found
  • Body: "Tag Not Found"
  • Status: 404
  • Status Text: "Not Found"
400 Bad Request
  • Body: string
  • Status: 400
  • Status Text: "Bad Request"

Types

Tag

type Tag = {
    id: number
    name: string
    slug: string
    groupName: string
}

Tags

type Tags = Tag[]

Product

type Product = {
    id: number
    slug: string
    title: string
    description: string
    image: {
        tall: string
        wide: string
    }
    price: number
    discount: number
    tags: Tag["id"][]
}

Products

type Products = Product[]