Dokumentazzjoni tal-API

Free REST API għal dejta element. L-ebda ċavetta API meħtieġa.

Ebda ċavetta API meħtieġa CORS attivata għall-oriġini kollha JSON
https://api.periodictableofelements.org

Dan l-API huwa b'xejn għall-użu għal proġetti personali, edukattivi u kummerċjali.Aħna biss nitolbu li inti tinkludi link lura għal PeriodicTableOfElements.org x'imkien fl-app tiegħek jew websajt.

Eżempju ta’ attribwiment:

<a href="https://periodictableofelements.org">Data from PeriodicTableOfElements.org</a>

Jew b’test sempliċi:

Data provided by PeriodicTableOfElements.org

Punti aħħarin

GET /elements/

Jirritorna l-118-il element kollha bi proprjetajiet ewlenin inklużi l-massa atomika, il-kategorija, il-konfigurazzjoni elettronika, il-punti tat-tidwib/togħlija, u l-pożizzjonijiet tal-grilja għat-tqassim tat-tabella.

Rate limit: 200/hr
Eżempju ta’ Rispons
[
  {
    "atomic_number": 1,
    "symbol": "H",
    "name": "Hydrogen",
    "slug": "hydrogen",
    "atomic_mass": 1.008,
    "category": "nonmetal",
    "block": "s",
    "group_number": 1,
    "period": 1,
    "state_at_room_temp": "gas",
    "electronegativity": 2.2,
    "ionization_energy": 1312.0,
    "electron_affinity": -73.0,
    "atomic_radius": 53,
    "density": 0.00008988,
    "melting_point": 14.01,
    "boiling_point": 20.28,
    "discovery_year": 1766,
    "category_color": "#2ecc71",
    "cpk_hex_color": "FFFFFF",
    "grid_row": 1,
    "grid_column": 1,
    "electrons_per_shell": [1],
    "electron_configuration_semantic": "1s1"
  },
  ...
]
Ipprovaha
fetch('https://api.periodictableofelements.org/elements/')
  .then(r => r.json())
  .then(data => console.log(data));
GET /elements/{atomic_number}/

Jirritorna data kompluta għal element wieħed, inklużi l-oqsma kollha: proprjetajiet fiżiċi, informazzjoni skoperta, isotopi, użi, fatti gost, u aktar.

Rate limit: 300/hr
Example Response — /elements/79/
{
  "atomic_number": 79,
  "symbol": "Au",
  "name": "Gold",
  "slug": "gold",
  "atomic_mass": 196.9666,
  "category": "transition_metal",
  "block": "d",
  "group_number": 11,
  "period": 6,
  "state_at_room_temp": "solid",
  "electronegativity": 2.54,
  "density": 19.3,
  "melting_point": 1337.33,
  "boiling_point": 3129.0,
  "discovery_year": -2500,
  "discovered_by": "Ancient civilizations",
  "electron_configuration": "1s2 2s2 2p6 3s2 3p6 3d10 4s2 4p6 4d10 5s1 4f14 5p6 5d10 6s1",
  "electron_configuration_semantic": "[Xe] 4f14 5d10 6s1",
  "oxidation_states": "+1, +3",
  "is_radioactive": false,
  "is_synthetic": false,
  ...
}
Ipprovaha
fetch('https://api.periodictableofelements.org/elements/79/')
  .then(r => r.json())
  .then(data => console.log(data));
GET /elements/quiz/

It-tipi ta' mistoqsijiet jinkludu: identifikazzjoni tas-simbolu, tfittxija tan-numru atomiku, klassifikazzjoni tal-kategorija, u ħjiel ibbażati fuq il-proprjetà.

Rate limit: 300/hr
Eżempju ta’ Rispons
{
  "type": "symbol",
  "question": "What element has the symbol Fe?",
  "choices": [
    {"name": "Iron", "atomic_number": 26},
    {"name": "Fluorine", "atomic_number": 9},
    {"name": "Francium", "atomic_number": 87},
    {"name": "Fermium", "atomic_number": 100}
  ],
  "answer": 26
}
Ipprovaha
fetch('https://api.periodictableofelements.org/elements/quiz/')
  .then(r => r.json())
  .then(data => console.log(data));
GET /elements/element-of-the-day/

Jirritorna l-element li jidher illum. L-element jinbidel kuljum u jgħaddi mill-118-il element kollha. Jinkludi sommarju u fatt divertenti.

Rate limit: 200/hr
Eżempju ta’ Rispons
{
  "atomic_number": 6,
  "symbol": "C",
  "name": "Carbon",
  "slug": "carbon",
  "category": "nonmetal",
  "category_color": "#2ecc71",
  "summary": "Carbon is a chemical element...",
  "fun_fact": "Carbon can form nearly 10 million different compounds...",
  "atomic_mass": 12.011,
  "discovery_year": -3750,
  "date": "2026-03-29"
}
Ipprovaha
fetch('https://api.periodictableofelements.org/elements/element-of-the-day/')
  .then(r => r.json())
  .then(data => console.log(data));
GET /elements/molar-mass/?formula={formula}

Ħassar

Rate limit: 300/hr
Example Response — /elements/molar-mass/?formula=H2O
{
  "formula": "H2O",
  "molar_mass": 18.015,
  "breakdown": [
    {
      "symbol": "H",
      "count": 2,
      "atomic_mass": 1.008,
      "subtotal": 2.016
    },
    {
      "symbol": "O",
      "count": 1,
      "atomic_mass": 15.999,
      "subtotal": 15.999
    }
  ]
}
Ipprovaha
fetch('https://api.periodictableofelements.org/elements/molar-mass/?formula=H2O')
  .then(r => r.json())
  .then(data => console.log(data));
GET /elements/export/json/

Tniżżel l-elementi kollha 118 bħala fajl JSON ifformattjat.Inkludi proprjetajiet atomiċi, informazzjoni skoperta, konfigurazzjonijiet elettroniċi, u aktar.

Rate limit: 20/hr Jirritorna: applikazzjoni/json mehmuż
GET /elements/export/csv/

Niżżel l-elementi kollha 118 bħala fajl CSV.Ismijiet istess bħall-esportazzjoni JSON, adattati għall-spreadsheets u l-analiżi tad-dejta.

Rate limit: 20/hr Jirritorna: test/csv mehmuż

Limiti tar-rata

Endpoint Limit
/elements/ 200 requests/hour
/elements/{n}/ 300 requests/hour
/elements/quiz/ 300 requests/hour
/elements/element-of-the-day/ 200 requests/hour
/elements/molar-mass/ 300 requests/hour
/elements/export/json/ 20 requests/hour
/elements/export/csv/ 20 requests/hour

Il-limiti tar-rata huma għal kull indirizz IP.Jekk jinqabeż il-limitu, jiġi rritornat HTTP 429 (Too Many Requests).

Eżempji ta’ Kodiċi

// Fetch all elements
fetch('https://api.periodictableofelements.org/elements/')
  .then(res => res.json())
  .then(elements => {
    console.log(`Loaded ${elements.length} elements`);
    elements.forEach(el => {
      console.log(`${el.symbol} - ${el.name} (${el.atomic_mass})`);
    });
  });

// Get a single element
fetch('https://api.periodictableofelements.org/elements/79/')
  .then(res => res.json())
  .then(gold => {
    console.log(`${gold.name}: ${gold.atomic_mass} u`);
  });

// Calculate molar mass
fetch('https://api.periodictableofelements.org/elements/molar-mass/?formula=H2SO4')
  .then(res => res.json())
  .then(data => {
    console.log(`${data.formula}: ${data.molar_mass} g/mol`);
  });

// Get element of the day
fetch('https://api.periodictableofelements.org/elements/element-of-the-day/')
  .then(res => res.json())
  .then(el => {
    console.log(`Today's element: ${el.name} (${el.symbol})`);
  });
# Fetch all elements
import requests

response = requests.get('https://api.periodictableofelements.org/elements/')
elements = response.json()
print(f'Loaded {len(elements)} elements')

for el in elements:
    print(f"{el['symbol']} - {el['name']} ({el['atomic_mass']})")

# Get a single element
gold = requests.get('https://api.periodictableofelements.org/elements/79/').json()
print(f"{gold['name']}: {gold['atomic_mass']} u")

# Calculate molar mass
data = requests.get(
    'https://api.periodictableofelements.org/elements/molar-mass/',
    params={'formula': 'H2SO4'}
).json()
print(f"{data['formula']}: {data['molar_mass']} g/mol")

# Get element of the day
el = requests.get(
    'https://api.periodictableofelements.org/elements/element-of-the-day/'
).json()
print(f"Today's element: {el['name']} ({el['symbol']})")

Niżżel id-Dejta

JSON

Kollha 118 elementi mal-proprjetajiet sħiħa. Ideali għall-web apps u l-iskripts.

Niżżel il-JSON

CSV

Format faċli għall-ispreadsheet. Iftaħ fl-Excel, Google Sheets, jew Pandas.

Niżżel il-CSV