Skip to main content

​
Lookup API token status

Action ID: tools.spur.lookup_api_token_status Retrieve the Spur API token’s status, the number of queries it can still make, and the service tier. Does not use a query. Calls GET /status directly. Reference: https://docs.spur.us/context-api/endpoints#lookup-api-token-status

​
Secrets

Required secrets:
  • spur: required values SPUR_TOKEN.

​
Input fields

​
string | null
Spur API base URL.Default: null.

​
Lookup IP address

Action ID: tools.spur.lookup_ip Retrieve the Spur IP Context Object for an IPv4 or IPv6 address, or the context for a past date when dt is set. Calls GET /v2/context/{ip} directly. Reference: https://docs.spur.us/context-api/endpoints#lookup-an-ip-address

​
Secrets

Required secrets:
  • spur: required values SPUR_TOKEN.

​
Input fields

​
string
required
Public IPv4 or IPv6 address to look up.
​
string | null
Spur API base URL.Default: null.
​
string | null
A datetime in the format YYYYmmdd. Only valid for tokens with the Context API Historical Query permission (Pro plans and above); other tokens get a 401.Default: null.
​
integer | null
A boolean value, that when set to 1, will return MaxMind’s GeoLite2 geolocation data instead of Spur’s geolocation data in the location object.Default: null.

​
Lookup tag metadata

Action ID: tools.spur.lookup_tag_metadata Retrieve the Spur Tag Metadata Object (summary, metrics and attributes) for a service tag such as OXYLABS_PROXY or PROTON_VPN. Calls GET /v2/metadata/tags/{tag} directly. Reference: https://docs.spur.us/context-api/endpoints#lookup-tag-metadata

​
Secrets

Required secrets:
  • spur: required values SPUR_TOKEN.

​
Input fields

​
string
required
Service tag to look up, e.g. a tunnel operator or proxy tag returned in an IP Context Object (OXYLABS_PROXY, PROTON_VPN).
​
string | null
Spur API base URL.Default: null.