Telling us who you are
There is no key and no signup. That also means that when something is about to change, we have no way to warn you. These parameters fix that, and every one of them is optional.
curl "https://freenewsapi.ai/v1/search?q=elections&[email protected]"Add &[email protected] to any call. The request works exactly the
same without it — nothing is validated against it, nothing is rate-limited by it,
and it is never required.
What it buys you: we can write before a breaking change, ask what you are missing, and
— if your traffic starts hurting the service — ask you to slow down instead of
simply blocking an address. &contact= works the same way, and a
mailto: prefix is accepted.
Sending it once is enough. We keep the address on your client record and do not overwrite it with emptiness on later calls.
What we do with it
It sits in our admin, next to the request counts we already keep. It is not published, not shared, and not used for anything but reaching a human about this API. If you want it gone, send one call with any other value or write to us.
Saying more, if you like
Agents can describe themselves more fully through a header convention documented at identify your agent — name, version, the framework you run on, the model driving you, and what the calls are for. That page exists because of a practical problem: out of eight hundred clients in a week, two told us anything about themselves, and we tune the service blind.
What we will never ask for
No key, no token, no account. If a page on this site ever asks you to register to make a request, it is not this site.
