Bento
  • Go to Marketing Site
  • Go to App

  • User Work Laptop Streamline Icon: https://streamlinehq.comAccount

  • Graduation Cap Streamline Icon: https://streamlinehq.comGet Started

  • Migration Guides

  • DNS Setup

  • Connection Integration System Api Streamline Icon: https://streamlinehq.comAPI for Developers

    • Introduction
    • Quickstart
    • Authentication
    • Subscribers API
    • Events API
    • Emails API
    • Tags API
    • Fields API
    • Broadcasts API
    • Stats API
    • Spam API

  • Package Streamline Icon: https://streamlinehq.comSDK Guides

  • Plugs Streamline Icon: https://streamlinehq.comIntegrations

  • Horizontal Menu Streamline Icon: https://streamlinehq.comMisc

  • Sign in

Spam API (and more)

Experimental APIs that are designed for specific use cases, offering advanced functionalities tailored to niche use cases.

These endpoints are all considered experimental and subject to change, as we continuously refine and enhance based on user feedback and technological changes.

Available Endpoints

MethodEndpointName
GETexperimental/blacklist.jsonSearch Blacklists
POSTexperimental/validationValidate Email
POSTexperimental/jesses_rulesetValidate Email (Jesse's Ruleset)
POSTexperimental/content_moderationModerate Content
POSTexperimental/genderGuess Gender
GETexperimental/geolocationGeolocate IP Address
GET/v1/experimental/blacklist.json

Search Blacklists

The Blacklist Model

Validates the IP or domain name with industry email reputation services to check for delivery issues.

A true value for any of the keys in the model indicates a problem

Properties

  • Name
    just_registered
    Type
    boolean
    Description

    true / false flag if the domain age is flagged.

  • Name
    spamhaus
    Type
    boolean
    Description

    Spamhaus considers mail from this domain or ip to be contain likely spam.

  • Name
    nordspam
    Type
    boolean
    Description

    Nordspam considers mail from this domain or ip to likely contain spam.

  • Name
    spfbl
    Type
    boolean
    Description

    Spfbl considers mail from this domain or ip to likely contain spam.

  • Name
    sorbs
    Type
    boolean
    Description

    Sorbs considers mail from this domain or ip to likely contain spam.

  • Name
    abusix
    Type
    boolean
    Description

    Abusix considers mail from this domain or ip to likely contain spam.



You can provide either a domain or an IP to be looked up.

Only IPV4 addresses are currently supported.

Required Attributes

  • Name
    domain
    Type
    string
    Description

    Please provide just the domain (e.g., google.com) without including the protocol (such as http:// or https://)

  • Name
    ip_address
    Type
    string
    Description

    Please provide just the IP address.



Response

Returns the details of the reputation check.

Results can be null if all the checks return false.
POST/v1/experimental/validation

Validate Email

The Validate Email Model

Validates the email address using the provided information to infer its validity.

Properties

  • Name
    valid
    Type
    boolean
    Description

    true / false flag if the email address is considered valid.



Validate the submitted email address against spam patterns.

Required Attributes

  • Name
    email
    Type
    string
    Description

    Validates an email's domain using MX records.

Optional Attributes

  • Name
    name
    Type
    string
    Description

    The contacts full name. Heavy bias towards US Census Data. False positives possible.

  • Name
    user_agent
    Type
    string
    Description

    The user agent as a string.

  • Name
    ip
    Type
    string
    Description

    The users IP address. Returns false for all countries outside of Tier 1.



Response

Returns the details of the validation check.

POST/v1/experimental/jesses_ruleset

Validate Email (Against Jesse's Ruleset)

The Validate Email (Against Jesse's Ruleset) Model

Validates the email address using the provided information to infer its validity. This is a custom ruleset that Jesse, the Founder of Bento, has created that we use in our own application. It is extremely strict so use with caution. We recommend logging failures to monitor them so you don't get any false positives.



Required Attributes

  • Name
    email
    Type
    string
    Description

    Validates an email's domain using MX records.

Optional Attributes

  • Name
    block_free_providers
    Type
    boolean
    Description

    Whether to block free email providers.

  • Name
    wiggleroom
    Type
    boolean
    Description

    Set to true to reduce a few extremely opinionated checks.



Response

Returns the details of the validation check.

POST/v1/experimental/content_moderation

Moderate Content

The Moderate Content Model

An opinionated Content moderation.

Properties

  • Name
    valid
    Type
    boolean
    Description

    true / false flag if the supplied content is considered safe.

  • Name
    reasons
    Type
    array
    Description

    string values of the issues found with the supplied content.

  • Name
    safe_original_content
    Type
    string
    Description

    A safe version of the supplied content.



This endpoint will return an opinionated moderation score based on the content provided. This is optimised for small amounts of text content, where you never want a link/XSS/etc inside it.

Required Attributes

  • Name
    content
    Type
    string
    Description

    The content you wish to moderate.



Response

Returns results of the content moderation.

POST/v1/experimental/gender

Guess Gender

The Gender Guess Model

Guess a subscriber's gender using their first and last name. Best for US users; based on US Census Data.

Properties

  • Name
    gender
    Type
    string
    Description

    The guessed gender based on census data.

  • Name
    confidence
    Type
    float
    Description

    Confidence level of the guess.



This endpoint allows you to guess the gender of a subscriber based on their first name and last name. Works best with US users as we use US Census Data to make our guesses.

Required Attributes

  • Name
    name
    Type
    string
    Description

    This can be the full name of a subscriber or last name.



Response

The result of the guessed gender.

The response will always return a confidence level.
GET/v1/experimental/geolocation

Geolocate IP Address

The Geolocate IP Address Model

This endpoint attempts to geolocate the provided IP address.

This only works with IPV4 IP Addresses

Properties

  • Name
    request
    Type
    string
    Description

    The provided IP address that was geolocated.

  • Name
    ip
    Type
    string
    Description

    The IP address that was geolocated.

  • Name
    country_code2
    Type
    string
    Description

    Two letter country code.

  • Name
    country_code3
    Type
    string
    Description

    Three letter country code.

  • Name
    country_name
    Type
    string
    Description

    Full name of the country.

  • Name
    continent_code
    Type
    string
    Description

    The continent code.

  • Name
    region_name
    Type
    string
    Description

    The regional name.

  • Name
    city_name
    Type
    string
    Description

    City name.

  • Name
    postal_code
    Type
    string
    Description

    Regional postal code.

  • Name
    latitude
    Type
    number
    Description

    Latitude for the ip address.

  • Name
    longitude
    Type
    number
    Description

    Longitude for the ip address.

  • Name
    dma_code
    Type
    string
    Description

    DMA code for the ip address.

  • Name
    area_code
    Type
    string
    Description

    Area code if available for the ip address.

  • Name
    timezone
    Type
    string
    Description

    Regional time UTC time zone.

  • Name
    real_region_name
    Type
    string
    Description

    The real region name.



This end point will geolocate the provided ip address.

Required Attributes

  • Name
    ip
    Type
    string
    Description

    The IPV4 address you with to geolocate.



Response

The result of the ip geolocation.

The response will contain null values for keys.
PreviousStats API
NextSDKs

© Copyright 2025. All rights reserved.

Follow us on XFollow us on GitHubJoin our Discord server

What's on this page

  • Available Endpoints
  • GETSearch Blacklists
  • The Blacklist Model
  • POSTValidate Email
  • The Validate Email Model
  • POSTValidate Email (Against Jesse's Ruleset)
  • The Validate Email (Against Jesse's Ruleset) Model
  • POSTModerate Content
  • The Moderate Content Model
  • POSTGuess Gender
  • The Gender Guess Model
  • GETGeolocate IP Address
  • The Geolocate IP Address Model