{"uid":"cap_1c-zDuMs9BAwHwx-64D45","slug":"apiosk-gateway-ipdata-execute-625273e3","name":"Apiosk Gateway – IPData 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/ipdata/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.13","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.13/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_H-0SY3fTKUv43pS-BHatm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.13","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a pay-per-call IP data lookup via the x402 protocol, forwarding a JSON payload to the ipdata provider and returning geolocation and enrichment results.","exampleAgentPrompt":"Look up the geolocation and ISP details for IP address 8.8.8.8 using the ipdata endpoint — I need the country, city, and organization name.","exampleUseCases":[{"title":"Geolocate visitor IP for analytics","prompt":"Can you look up where 203.0.113.42 is located — I need the country, city, and whether it's a VPN or proxy, so I can flag suspicious signups."},{"title":"ISP and ASN lookup for network ops","prompt":"Get me the ISP name and ASN for IP 198.51.100.10 — I'm trying to figure out which network provider is behind this connection."},{"title":"Timezone resolution from IP address","prompt":"What timezone is associated with the IP address 91.108.4.1? I want to schedule a notification at the right local time for that user."}],"resultDescription":"Returns a JSON object with status, the upstream ipdata response body (containing geolocation fields such as country, city, latitude, longitude, ISP, ASN, threat flags, timezone, etc.), the operation used, latency in milliseconds, cost string, and upstream HTTP status code.","failureModes":["Invalid or private IP address returns an error from the upstream ipdata provider","Malformed JSON in the input field causes a parsing error","Unknown operation selector returns a 404 or operation-not-found error","Insufficient USDC balance or failed x402 payment results in a 402 response and no execution","Upstream ipdata service unavailability causes a timeout or 5xx upstream_status"],"whenToPreferThis":"Choose this endpoint when you need IP geolocation or enrichment data and are already operating in an x402/USDC micropayment context, or when you want per-call billing without API key management. Prefer over direct ipdata API calls when using the Apiosk gateway for unified billing across multiple data providers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:25:45.928Z","isFirstParty":false}