{"uid":"cap_s2UwS5h7aKOda9-joUYKB","slug":"apiosk-gateway-ipstack-execute-013761b9","name":"Apiosk Gateway – IPStack Execute","description":"Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.","url":"https://gateway.apiosk.com/ipstack/execute","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","description":"JSON payload forwarded to the selected operation."},"operation":{"type":"string","description":"Operation id, /path, or METHOD /path selector."}}},"responseSchema":{"type":"object","required":["status","result"],"properties":{"api":{"type":"string"},"cost":{"type":"string"},"result":{"description":"Upstream response body."},"status":{"type":"string"},"latency":{"type":"number"},"operation":{"type":"string"},"upstream_status":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0805","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.07/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fvQDKG-Pq06gbYNtYKmHk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.07","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Execute an IPStack IP geolocation lookup via the Apiosk x402 pay-per-call gateway, returning location data for a given IP address.","exampleAgentPrompt":"Look up the geolocation for IP address 8.8.8.8 — I need the country, city, region, and timezone.","exampleUseCases":[{"title":"Fraud detection by IP origin","prompt":"I have a suspicious login from IP 185.220.101.45 — can you look up where that IP is located and what ISP it belongs to?"},{"title":"Personalizing content by visitor location","prompt":"A user just landed on our site from IP 203.0.113.72 — geolocate it so we can show them region-appropriate pricing and language."},{"title":"Audit log enrichment with location","prompt":"We have a list of IP addresses from our server access logs and I need the country and city for each one — start with 91.108.4.1."}],"resultDescription":"Returns a JSON object with status, the upstream IPStack response body (country, country_code, region, city, latitude, longitude, timezone, ISP, and related fields), the operation called, latency in milliseconds, cost, and the upstream HTTP status code.","failureModes":["Invalid or malformed IP address returns an upstream error from IPStack","Insufficient USDC balance or failed x402 payment causes a 402 response before execution","Unknown or unsupported operation selector returns an error from the gateway","Rate limiting or IPStack quota exceeded returns a non-200 upstream_status","Private/reserved IP ranges may return empty or partial geolocation data"],"whenToPreferThis":"Choose this endpoint when you need IP geolocation data powered by IPStack and want to pay per call in USDC via the x402 protocol without managing API key subscriptions. Ideal for agents that need on-demand, pay-as-you-go geolocation without provisioning credentials directly with IPStack.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:48:19.237Z","isFirstParty":false}