Sækja gögn

Þetta eru forritaskil QuickLookup sjálfs, aðgengileg hér þegar lykillinn þinn og mörk leiðarinnar hafa verið athuguð. Þrjú köll duga oftast: finna þjónustu, lesa samning hennar og spyrja hana.

curl -H "Authorization: Bearer $QL_KEY" \
  "https://audvitad.snjallgogn.is/api/v1/catalog/services?q=weather"

curl -H "Authorization: Bearer $QL_KEY" \
  "https://audvitad.snjallgogn.is/api/v1/catalog/services/037fd8b2-2918-5e6e-8bee-13bfec7c8326"

curl -H "Authorization: Bearer $QL_KEY" -H "Content-Type: application/json" \
  "https://audvitad.snjallgogn.is/api/v1/services/037fd8b2-2918-5e6e-8bee-13bfec7c8326/query" \
  -d '{
  "inputs": {
    "from": "2026-11-12T00:00:00Z",
    "to": "2027-02-10T00:00:00Z",
    "country_code": "IS"
  },
  "order": "asc",
  "limit": 100
}'

Breyttu nánast hvaða inntaki sem er (heiti, heimilisfangi, hnitum, IP-tölu, símanúmeri, netfangi eða vefslóð) í stað og spurðu svo um allt sem vitað er um staðinn á tilteknum degi.

curl -H "Authorization: Bearer $QL_KEY" -H "Content-Type: application/json" \
  "https://audvitad.snjallgogn.is/api/v1/resolve" -d '{
  "input": "Harpa",
  "countryCodes": [
    "IS"
  ]
}'

curl -H "Authorization: Bearer $QL_KEY" -H "Content-Type: application/json" \
  "https://audvitad.snjallgogn.is/api/v1/context/day" -d '{
  "location": {
    "resolve": "Harpa"
  },
  "date": "2026-11-12",
  "timezone": "Atlantic/Reykjavik"
}'

Leitað er í öllum viðburðastraumum í einu og næstu viðburðir koma fyrst. Dæmið sýnir viðburði dagsins innan 2 km frá miðborg Reykjavíkur.

curl -H "Authorization: Bearer $QL_KEY" -H "Content-Type: application/json" \
  "https://audvitad.snjallgogn.is/api/v1/events/search" -d '{
  "from": "2026-11-12T00:00:00Z",
  "to": "2026-11-13T00:00:00Z",
  "near": {
    "latitude": 64.1466,
    "longitude": -21.9426,
    "radiusKm": 2
  },
  "order": "distance_asc",
  "limit": 50
}'

import os, httpx

api = httpx.Client(
    base_url="https://audvitad.snjallgogn.is/api/v1",
    headers={"Authorization": f"Bearer {os.environ['QL_KEY']}"},
)

# Hourly weather for a point in Reykjavík, today
body = {
    "inputs": {"from": "2026-11-12T00:00:00Z", "to": "2026-11-13T00:00:00Z",
               "lat": 64.1466, "lon": -21.9426},
    "limit": 100,
}
rows, cursor = [], None
while True:
    page = api.post("/services/84451ef4-fc70-5f94-8346-01e2a5e69f5f/query",
                    json={**body, "cursor": cursor}).raise_for_status().json()
    rows += page["items"]
    cursor = page.get("nextCursor")
    if not cursor:
        break
print(len(rows), "rows")

Svör koma í síðum með allt að 10.000 línum. Sendu nextCursor óbreytt til baka þar til það er tómt. Svörum fylgir ETag. Sendu það til baka sem If-None-Match og ef svarið er óbreytt kemur 304 án innihalds.

MCP-þjónn QuickLookup veitir agentum/drekum aðgang að sömu gögnum og REST-forritaskilin, með verkfærum sem aðeins lesa. Hann notar Streamable HTTP og API-lykillinn þinn er auðkennið.

Claude Code

claude mcp add --transport http audvitad https://audvitad.snjallgogn.is/mcp \
  --header "Authorization: Bearer $QL_KEY"

Biðlarar sem stilltir eru með JSON (Claude Desktop, Cursor og fleiri)

{
  "mcpServers": {
    "audvitad": {
      "type": "http",
      "url": "https://audvitad.snjallgogn.is/mcp",
      "headers": {
        "Authorization": "Bearer <your API key>"
      }
    }
  }
}

Verkfæri

list_data_services

Leita í gagnaskránni.

get_data_service

Lesa samning þjónustu og keyranleg dæmi hennar.

query_data_service

Spyrja þjónustu.

search_nearby_events

Viðburðir nálægt punkti, í öllum straumum.

list_time_series_families

Finna fjölskyldur skyldra tímaraða.

get_time_series_family

Skoða fjölskyldu og raðir hennar.

list_saved_context, get_saved_context, resolve_saved_context, query_saved_event_context

Vistaðir staðir og samhengi þeirra.

Í Fagi og Fyrirtæki má sækja sömu gögn með SQL í gegnum merkingarlagið okkar, úr hvaða Postgres- eða MySQL-biðlara, BI-tóli eða vinnubók sem er. Hafðu samband til að fá tengiupplýsingarnar.

Fyrirspurn er REST-kall eða MCP-verkfærakall sem QuickLookup svaraði. Höfnuð köll og villur okkar megin kosta ekkert, og ekki heldur MCP-skilaboð eins og verkfæralistinn. Talið er á hvert fyrirtæki í hverjum mánuði (UTC); sjá verð.

Hverju svari fylgja mörkin og hvað er eftir af þeim:

X-Quota-Limit · X-Quota-Remaining

fyrirspurnir mánaðarins og hve margar eru eftir

X-Credits-Remaining

aukafyrirspurnir eftir, þegar mánuðurinn er búinn

X-RateLimit-Limit · X-RateLimit-Remaining

fyrirspurnir á mínútu og hve margar eru eftir

RateLimit-Policy

sekúndan og mínútan sem leiðin leyfir

Retry-After

sekúndur þar til má reyna aftur, með hverju 429-svari

• Sumar heimildir krefjast þess að þeirra sé getið hvar sem gögn þeirra birtast. Heimildir sýna hverjar það eru og nákvæmt orðalag.
• Úrvalsgögn frá þriðja aðila, eins og markaðir og hagvísar Trading Economics, eru aðeins í boði þar sem leyfi veitandans heimilar það. Spurðu okkur um leiðina Fyrirtæki.