IPGeolocation.io + Pipedream Integration

1. Get your API key

1. Sign up at IPGeolocation.io. A free plan is available with 1,000 lookups per day.
2. After logging in, copy your API Key from the dashboard.

2. Connect IPGeolocation.io to Pipedream

1. Open Pipedream and create a new workflow (or open an existing one).

2. Add a new step and search for IPGeolocation.

Expand

3. Click Connect Account and paste your API key when prompted.

Expand

4. Your account is now linked and ready to use across all 12 actions.

3. Add an action

Select any of the actions listed below, configure the required fields, and deploy your workflow. Each action returns a structured JSON response that can be referenced by downstream steps using Pipedream's steps object.

Expand

1. Get IP Geolocation

• Endpoint: GET /v3/ipgeo

Looks up geolocation data for a single IPv4 or IPv6 address (or domain). Returns country, city, state, coordinates, timezone, currency, ASN, and more depending on your plan.

Inputs

Expand

Example use case: Enrich a new sign-up event with the user's country and timezone before writing to your CRM.

// Reference the result in a downstream step
const country = steps.get_geolocation.$return_value.location.country_name;
const timezone = steps.get_geolocation.$return_value.time_zone.name;

2. Get Bulk IP Geolocation

• Endpoint: POST /v3/ipgeo-bulk
• Availability: Paid Plans

Enriches up to 50,000 IP addresses or domains in a single request. Ideal for batch processing log files, user tables, or event streams.

Inputs

Expand

Example use case: Nightly enrichment of a database table of raw IP addresses from your access logs.

3. Get IP Security

• Endpoint: GET /v3/security
• Availability: Paid Plans

Returns threat intelligence for a single IP: VPN/proxy/Tor detection, bot flags, threat score, spam indicators, and cloud provider identification.

Inputs

Expand

Example use case: Block or flag a login attempt if the IP has a high threat score or is detected as a known proxy.

const security = steps.get_ip_security.$return_value.security;
if (security.threat_score > 70 || security.is_proxy) {
  // trigger alert or deny action
}

4. Get Bulk IP Security

• Endpoint: POST /v3/security-bulk
• Availability: Paid Plans

Runs threat intelligence checks on up to 50,000 IP addresses at once. Returns per-IP security signals including VPN/proxy/Tor flags, threat scores, and bot detection.

Inputs

Expand

Example use case: Screen a list of IPs from a suspicious traffic spike for proxy/VPN usage before taking automated action.

5. Get ASN Details

• Endpoint: GET /v3/asn
• Availability: Paid Plans

Returns Autonomous System Number (ASN) data including AS number, organization name, IP ranges, peering info, and WHOIS details. Accepts an IP address or ASN number.

Inputs

Expand

Example use case: Identify whether traffic is coming from a known cloud provider or hosting ASN to flag automated requests.

6. Get Abuse Contact

• Endpoint: GET /v3/abuse
• Availability: Paid Plans

Retrieves the abuse contact information registered for an IP address, including the responsible organization, email addresses, and phone numbers.

Inputs

Expand

Example use case: Automatically compose and send an abuse report email when your WAF detects a repeated attacker IP.

const abuse = steps.get_abuse_contact.$return_value.abuse;
// abuse.emails[0] → abuse contact email
// abuse.name      → responsible organization

7. Get Timezone

• Endpoint: GET /v3/timezone

Looks up timezone data for a location specified by IP address, coordinates, timezone name, city name, IATA airport code, ICAO code, or UN/LOCODE. Returns current time, UTC offset, DST status, and more.

Inputs

Expand

Example use case: Detect a user's local timezone from their IP on sign-up and pre-fill it in their account preferences.

8. Convert Timezone

• Endpoint: GET /v3/timezone/convert

Converts a date/time from one timezone (or location) to another. Accepts timezone names, coordinates, city names, IATA codes, ICAO codes, or UN/LOCODEs as selectors for both the source and destination.

Inputs

Expand

Example use case: Schedule a meeting notification by converting HQ local time to each participant's timezone before sending calendar invites.

9. Parse User Agent

• Endpoint: POST /v3/user-agent
• Availability: Paid Plans

Parses a single user agent string and returns structured data: browser name, version, device type, brand, CPU, operating system, and rendering engine.

Inputs

Expand

Example use case: Segment analytics by device type (mobile vs. desktop) or browser to identify UX issues for specific environments.

const ua = steps.parse_user_agent.$return_value;
// ua.name              → "Chrome"
// ua.device.type       → "Desktop"
// ua.operating_system.name → "Mac OS"

10. Parse Bulk User Agents

• Endpoint: POST /v3/user-agent-bulk
• Availability: Paid Plans

Parses up to 50,000 user agent strings in a single request. Returns the same structured breakdown as the single-UA action for each entry.

Inputs

Expand

Example use case: Batch-analyze a day's worth of raw request logs to classify traffic by browser and device before loading into your analytics warehouse.

11. Get Astronomy Data

• Endpoint: GET /v3/astronomy

Returns sunrise, sunset, moonrise, moonset, solar noon, and moon phase for a given location and date. Location can be specified by IP address, coordinates, or city name.

Inputs

Expand

Example use case: Power an outdoor scheduling app by fetching sunrise/sunset times for a user's detected location before confirming booking slots.

12. Get Astronomy Time Series

• Endpoint: GET /v3/astronomy/timeSeries

Returns astronomy data (sunrise, sunset, moonrise, moonset, moon phase) for every day within a specified date range, up to 90 days.

Inputs

Expand

Example use case: Pre-generate a three-month calendar of golden-hour photography windows for a given location and export to a spreadsheet via Google Sheets.

1. Fraud detection on new sign-ups

Trigger: New row in database (e.g., Supabase, Airtable) Steps:

1. Get IP Geolocation — enrich with country and city
2. Get IP Security — check threat score, proxy/VPN flags
3. Conditional branch — if threat_score > 60, send a Slack alert and flag the record; otherwise continue onboarding

2. Nightly log enrichment

Trigger: Schedule (daily at midnight) Steps:

1. Fetch raw IP list from your data warehouse (e.g., BigQuery, Snowflake)
2. Get Bulk IP Geolocation — enrich all IPs with location and ASN
3. Write enriched records back to the warehouse

3. Localized email scheduling

Trigger: New subscriber added to mailing list Steps:

1. Get Timezone (by IP) — detect subscriber's local timezone
2. Convert Timezone — convert your send time from UTC to local time
3. Schedule the email send via your ESP (e.g., Mailchimp, SendGrid)