Name: extract-entities
Price: 0.005 USDC
Availability: InStock

$ man extract-entities

agentutility / wordmint / extract-entities

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

wordmint

CATEGORY

STATUS

● live

NAME

extract-entities — pulls structured entities out of free text: people, organizations, locations, dates, email addresses, urls, phone numbers, and monetary a…

SYNOPSIS

POST https://x402.agentutility.ai/extract-entities
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Pulls structured entities out of free text: people, organizations, locations, dates, email addresses, URLs, phone numbers, and monetary amounts, each returned verbatim as it appears in the source so you can locate it again. Send text and get back an entities object grouped by type plus total_entities, powered by an LLM extraction pipeline with automatic fallback if the primary provider is unavailable. Use it as a named entity recognition (NER) API, entity extractor, or information extraction tool for parsing contracts, emails, invoices, and news text into structured fields.

INPUT — request schema

property	type	description	req?
text	string	Max 25,000 chars.	required

OUTPUT — response shape

field	type	description
entities	object	Object with arrays: people, organizations, locations, dates, emails, urls, phone_numbers, amounts (each amount has mention/value/currency).
total_entities	number	Count of entities extracted across all categories (people, orgs, locations, dates, emails, URLs, phones, amounts).
input_chars	number	Character count of the input text submitted for entity extraction.
model	string	Mistral model identifier used to perform the named entity recognition pass.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/extract-entities \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the extract-entities tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: nlpnerentitiesextractionaillm
env: VENICE_API_KEY
methods: POST
cluster: wordmint
price: $0.005 USDC per call

ADJACENT — other endpoints in wordmint

endpoint	description	price
brand-tagline	Generates brand taglines and slogans for launch pages, X bios, email copy, and product cards.	$0.005
brand-tagline-generate	Generates tagline options for a brand or startup from its name, concept, audience, and tone.	$0.005
card-resolve	Normalizes free-form graded card text into a canonical card object.	$0.005
content-simhash	Fingerprints text with a 64-bit SimHash for near-duplicate detection, computed entirely locally.	$0.005
cron-parse	Cron parser.	$0.005
detect-language	Identifies what language a piece of text is written in and how confident the call is, returning an ISO 639-1 code, the full language name…	$0.005
dictionary-define	Looks up English word definitions with pronunciation, part of speech, and synonyms.	$0.005
embedding-similarity	Measures how semantically similar two strings are: embeds both via Venice (default model: text-embedding-bge-m3) and returns the cosine s…	$0.005