Skip to content

IPDataInfo/ipdata-objc

Repository files navigation

IPData.info Objective-C SDK — Free IP Geolocation & Threat Intelligence API

CocoaPods CI License: MIT

Official Objective-C client for ipdata.info — a free, fast IP geolocation, ASN, and threat-intelligence API. Look up country, city, ASN, timezone, currency, and security flags (proxy/VPN/Tor/hosting) for any IPv4 or IPv6 address. Powered by ipdata.info.

Get a free API key

The public endpoint is free — 50 requests/min, no signup, no key. For higher rate limits and batch lookups, create a free API key at ipdata.info/register and manage it in your dashboard.

Install

CocoaPods

pod 'IPData'

Swift Package Manager

.package(url: "https://github.com/IPDataInfo/ipdata-objc.git", from: "0.1.0")

Quickstart

#import <IPData/IPData.h>

IPDataClient *client = [[IPDataClient alloc] init]; // free tier
[client lookup:@"8.8.8.8" completion:^(id result, NSError *error) {
    if (error) { NSLog(@"error: %@", error); return; }
    NSDictionary *info = result;
    NSLog(@"%@ %@ ASN %@", info[@"city"], info[@"country"], info[@"asn"]);
}];

Methods

Method What it returns
lookup:completion: Full geolocation record (own IP if ip is nil/empty)
geo:completion: Geo subset (city/region/country/lat/lon/tz)
asn:completion: ASN + ISP/registry for an IP
batchLookup:completion: Many IPs at once (requires an API key)
asnDetail:completion: ASN detail incl. prefixes
asnWhoisHistory:completion: ASN whois history
asnChangesWithCompletion: ASN change feed
threatDomain:/threatHash:/threatURL:completion: Threat-intel lookup (domain / file hash / URL)

Full response schema: ipdata.info API docs · SDK list.

Configuration

IPDataClient *client = [[IPDataClient alloc] initWithAPIKey:@"YOUR_KEY" // sent as X-Api-Key; switches to pro.ipdata.info
                                                     baseURL:nil        // or override, e.g. https://ipdata.info
                                                     timeout:10];       // seconds, default 10

Errors from non-2xx responses are returned as NSError in the IPDataErrorDomain domain, with code set to the HTTP status and localizedDescription from the API's {"error": "..."} body.

Rate limits

  • Free (ipdata.info): 50 req/min, no key.
  • Paid (pro.ipdata.info): higher limits + batchLookup, with an API key.

Other SDKs

12 official SDKs — see the full list at ipdata.info/docs/sdks: Python, Node.js, Go, PHP, Java, Rust, .NET, Kotlin, Swift, Dart, Bash, Objective-C.

License

MIT © ipdata.info

About

Official Objective-C SDK for the ipdata.info IP geolocation, ASN & threat-intelligence API

Topics

Resources

License

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors