Periodic Table API

Overview

To use Periodic Table, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

https://api.apiverve.com/v1/periodictable

Example

How to call the Periodic Table API in different programming languages.

curl -X GET \
  "https://api.apiverve.com/v1/periodictable?name=hydrogen" \
  -H "X-API-Key: your_api_key_here"

const response = await fetch('https://api.apiverve.com/v1/periodictable?name=hydrogen', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/periodictable?name=hydrogen', headers=headers)

data = response.json()
print(data)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/periodictable?name=hydrogen", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

{
  "status": "ok",
  "error": null,
  "data": {
    "name": "Hydrogen",
    "appearance": "colorless gas",
    "atomic_mass": 1.008,
    "boil": 20.271,
    "category": "diatomic nonmetal",
    "density": 0.08988,
    "discovered_by": "Henry Cavendish",
    "melt": 13.99,
    "molar_heat": 28.836,
    "named_by": "Antoine Lavoisier",
    "number": 1,
    "period": 1,
    "group": 1,
    "phase": "Gas",
    "source": "https://en.wikipedia.org/wiki/Hydrogen",
    "summary": "Hydrogen is a chemical element with chemical symbol H and atomic number 1. With an atomic weight of 1.00794 u, hydrogen is the lightest element on the periodic table. Its monatomic form (H) is the most abundant chemical substance in the Universe, constituting roughly 75% of all baryonic mass.",
    "symbol": "H",
    "xpos": 1,
    "ypos": 1,
    "wxpos": 1,
    "wypos": 1,
    "shells": [
      1
    ],
    "electron_configuration": "1s1",
    "electron_configuration_semantic": "1s1",
    "electron_affinity": 72.769,
    "electronegativity_pauling": 2.2,
    "ionization_energies": [
      1312
    ],
    "cpk-hex": "ffffff",
    "block": "s"
  }
}

Authentication

The Periodic Table API requires authentication via API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Periodic Table API directly in your browser with live requests and responses.

Parameters

The Periodic Table API supports multiple query options. Use one of the following:

Response

The Periodic Table API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <name>Hydrogen</name>
    <appearance>colorless gas</appearance>
    <atomic_mass>1.008</atomic_mass>
    <boil>20.271</boil>
    <category>diatomic nonmetal</category>
    <density>0.08988</density>
    <discovered_by>Henry Cavendish</discovered_by>
    <melt>13.99</melt>
    <molar_heat>28.836</molar_heat>
    <named_by>Antoine Lavoisier</named_by>
    <number>1</number>
    <period>1</period>
    <group>1</group>
    <phase>Gas</phase>
    <source>https://en.wikipedia.org/wiki/Hydrogen</source>
    <summary>Hydrogen is a chemical element with chemical symbol H and atomic number 1. With an atomic weight of 1.00794 u, hydrogen is the lightest element on the periodic table. Its monatomic form (H) is the most abundant chemical substance in the Universe, constituting roughly 75% of all baryonic mass.</summary>
    <symbol>H</symbol>
    <xpos>1</xpos>
    <ypos>1</ypos>
    <wxpos>1</wxpos>
    <wypos>1</wypos>
    <shells>
      <shell>1</shell>
    </shells>
    <electron_configuration>1s1</electron_configuration>
    <electron_configuration_semantic>1s1</electron_configuration_semantic>
    <electron_affinity>72.769</electron_affinity>
    <electronegativity_pauling>2.2</electronegativity_pauling>
    <ionization_energies>
      <ionization_energie>1312</ionization_energie>
    </ionization_energies>
    <cpk_hex>ffffff</cpk_hex>
    <block>s</block>
  </data>
</response>

status: ok
error: null
data:
  name: Hydrogen
  appearance: colorless gas
  atomic_mass: 1.008
  boil: 20.271
  category: diatomic nonmetal
  density: 0.08988
  discovered_by: Henry Cavendish
  melt: 13.99
  molar_heat: 28.836
  named_by: Antoine Lavoisier
  number: 1
  period: 1
  group: 1
  phase: Gas
  source: https://en.wikipedia.org/wiki/Hydrogen
  summary: >-
    Hydrogen is a chemical element with chemical symbol H and atomic number 1.
    With an atomic weight of 1.00794 u, hydrogen is the lightest element on the
    periodic table. Its monatomic form (H) is the most abundant chemical
    substance in the Universe, constituting roughly 75% of all baryonic mass.
  symbol: H
  xpos: 1
  ypos: 1
  wxpos: 1
  wypos: 1
  shells:
    - 1
  electron_configuration: 1s1
  electron_configuration_semantic: 1s1
  electron_affinity: 72.769
  electronegativity_pauling: 2.2
  ionization_energies:
    - 1312
  cpk-hex: ffffff
  block: s

Response Structure

All API responses follow a consistent structure with the following fields:

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Periodic Table through GraphQL to combine it with other API calls in a single request. Query only the periodic table data you need with precise field selection, and orchestrate complex data fetching workflows.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

POST https://api.apiverve.com/v1/graphql

query {
  periodictable(
    input: {
      name: "hydrogen"
    }
  ) {
    name
    appearance
    atomic_mass
    boil
    category
    density
    discovered_by
    melt
    molar_heat
    named_by
    number
    period
    group
    phase
    source
    summary
    symbol
    xpos
    ypos
    wxpos
    wypos
    shells
    electron_configuration
    electron_configuration_semantic
    electron_affinity
    electronegativity_pauling
    ionization_energies
    cpk_hex
    block
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

CORS Support

The Periodic Table API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Periodic Table requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Periodic Table API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Periodic Table

Official Periodic Table packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Periodic Table works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

People who used this also used...

Based on your interest in Periodic Table, you might also like these APIs:

Stars Lookup

Stars Lookup is a simple tool for looking up star data. It returns the star name, mass, diameter, and more.

1 credit per call

Meteorite Landings

Meteorites is a simple tool for getting meteorite data. It returns a list of meteorites that have fallen to Earth.

1 credit per call

Julian Day Calculator

Julian Day Calculator converts between Gregorian calendar dates and Julian Day Numbers (JDN). Julian Day is a continuous count of days used in astronomy and historical research.

1 credit per call