GET /{dataset}/search-by-name.php

usgs.gov:usgs-mineral-resources

Summary: Search mineral deposit records by name
Operation ID: searchByNameGeneric
Auth: unknown
Description

Given the name of a mine, prospect, or occurrence, returns data records of sites whose names match for various mineral deposit types

Parameters (5)

dataset (string, path, required)

Mineral deposit dataset

Constraints: {'enum': ['vms', 'sedznpb', 'sedexmvt', 'porcu', 'sedcu', 'nicrpge', 'carbonatite', 'ree', 'laterite', 'phosphate', 'podchrome', 'ardf']}

f (string, query, optional, default: JSON)

Output format

Constraints: {'enum': ['XML', 'JSON', 'HTML']}

q (string, query, required)

Name search text

r (string, query, optional, default: matches)

Relation to use: begins, contains, or matches (default)

Constraints: {'enum': ['begins', 'contains', 'matches']}

st (string, query, optional)

State name to restrict search

Examples (3)

TitleTypeURLAction
Search for gold mines matching 'Homestake' curl https://mrdata.usgs.gov/au/search-by-name.php?q=Homestake
Search copper deposits containing 'Bingham' in Utah curl https://mrdata.usgs.gov/cu/search-by-name.php?f=JSON&q=Bingham&r=contains&st=Utah
Search MRDS records beginning with 'Morenci' in Arizona curl https://mrdata.usgs.gov/mrds/search-by-name.php?q=Morenci&r=begins&st=Arizona

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:09:57.551232 200 5853ms
2026-03-23 09:47:30.034097 404 681ms
2026-03-23 09:18:31.444527 404 597ms

Response Changes

WhenOldNew
2026-03-23 10:09:57.551232 80c3fe2ae106 8969fa5b9ab0