Greip's Phone Number Scoring

A robust Apify Actor that validates and analyzes phone numbers using the Greip Phone Number Scoring API. This tool helps identify disposable, temporary, and VoIP phone numbers to enhance fraud detection and improve data quality.

🚀 Features

• Phone Number Validation: Comprehensive syntax validation and operational assessment
• Disposable Number Detection: Identify temporary and disposable phone numbers
• VoIP Service Detection: Detect numbers associated with VoIP services
• Carrier Information: Get carrier details for phone numbers
• Structured Output: Clean, well-formatted JSON results stored in datasets

Input Parameters

Parameter	Type	Required	Description
phone	string	✅	Phone number to validate and analyze
countryCode	string	✅	ISO 3166-1 alpha-2 country code (e.g., "US")
userID	string	❌	Optional user identifier for tracking

Output Format

The Actor outputs detailed information about each phone number:

{
    "phone": "+905343192830",
    "carrier": "Turkcell",
    "countryCode": "TR",
    "disposable": false,
    "isValid": true,
    "reason": ""
}

Output Field Descriptions

Phone Number Analysis Fields:

• isValid: Boolean indicating if the phone number is 100% safe and valid
• disposable: Boolean indicating if the phone number is disposable, temporary, or VoIP
• reason: Human-readable explanation of why the number is considered risky (empty if isValid is true)
• carrier: The name of the carrier/service provider for the phone number
• phone: The phone number that was analyzed
• countryCode: The ISO 3166-1 alpha-2 country code associated with the phone number

Use Cases

This Actor is perfect for:

• Fraud Prevention: Detect temporary and disposable phone numbers often used in fraudulent activities
• User Registration: Validate phone numbers during user sign-up to ensure legitimate contact information
• SMS Marketing: Filter out invalid and VoIP numbers to improve campaign effectiveness
• Multi-Account Detection: Identify users attempting to create multiple accounts with disposable numbers
• Data Quality: Ensure phone number databases contain only valid, operational numbers
• Customer Verification: Verify the legitimacy of customer-provided phone numbers

Phone Number Formats Supported

The API accepts phone numbers in various formats:

• +905343192830 (International format with + sign)
• 00905343192830 (International format with 00 prefix)
• 905343192830 (Without international prefix)
• 5343192830 (Local format)

Your feedback

We're always working on improving the performance of our Actors. If you have any technical feedback for phone number scoring or found a bug, please create an issue in the Issues tab.