{"uid":"cap_m4lrGeAy8icqqZR3ISc1E","slug":"ishob-dataset-lookup-api-5f0eb872","name":"ISHOB Dataset Lookup API","description":"36 MCP tools & x402 pay-per-call APIs for AI agents: crypto risk, web extraction, screenshots, agent alarms, weather, company data. No API key.","url":"https://api.ishob.com/v1/dataset/%7Bkey%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["key"],"properties":{"id":{"type":"string","maxLength":64,"description":"Return one record by id"},"key":{"type":"string","description":"Dataset key from /v1/datasets, e.g. world-cities, countries, archive-topics"},"page":{"type":"integer","minimum":0,"description":"Page number (default 0)"},"continent":{"type":"string","description":"Facet filter (countries), e.g. Europe"},"country_code":{"type":"string","description":"Facet filter (world-cities), e.g. FR"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"dataset":"world-cities","license":"CC-BY-4.0","records":[{"lat":48.85,"lon":2.35,"name":"Paris"}],"attribution":"Data from GeoNames ..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_w7gDGMDtgFcoddgVs0aRV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches paginated records from named reference datasets (e.g. world cities, countries, archive topics) by dataset key, with optional facet filters and single-record lookup.","exampleAgentPrompt":"Pull the first page of world cities in France from the ISHOB dataset API using the 'world-cities' dataset key and filter by country code FR.","exampleUseCases":[{"title":"City coordinates for geospatial enrichment","prompt":"Get me all the cities in Germany from the world-cities dataset — I need their names, latitudes, and longitudes for the first page of results."},{"title":"Country list filtered by continent","prompt":"Fetch the list of countries in Europe from the ISHOB countries dataset, first page, so I can build a dropdown for a region selector."},{"title":"Single record lookup by ID","prompt":"Retrieve the specific record with id 'Q90' from the world-cities dataset on ISHOB — I need just that one entry's details."}],"resultDescription":"A JSON object containing a count of total matching records, the dataset name, the license (e.g. CC-BY-4.0), an attribution string, and an array of records (e.g. city name, latitude, longitude for world-cities). Results are paginated by page number.","failureModes":["Invalid or unknown dataset key returns an error or empty result","Missing required 'key' query parameter causes a 400-level error","Requested page number beyond available pages returns empty records array","Invalid 'id' parameter returns no matching record","Network or payment failure (x402) may block access"],"whenToPreferThis":"Choose this endpoint when you need lightweight, paginated access to open reference datasets (world cities, countries, archive topics) without requiring an API key — especially when your agent supports x402 micropayment at $0.0001 USDC per call. Prefer it over heavyweight geocoding or data warehouse APIs for simple reference lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T12:41:29.504Z","isFirstParty":false,"canonicalSlug":"ishob-dataset-lookup-api-5f0eb872"}