NewsWhip API

Name: NewsWhip API
Brand: NewsWhip API
Availability: InStock

✓ Official Vendor SpecData EnrichmentData TransformationapiKey10 EndpointsREST

For Agents

Find articles and Facebook posts ranked by social engagement, identify top influencers, and pull engagement stats by region, publisher, or topic.

Install Jentic One Beta

Connect the NewsWhip API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the NewsWhip API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with NewsWhip API.

Surface trending content by geographic region through GET /region with country and language filters

Pull all articles published by a specific outlet via GET /publisher for competitive coverage analysis

Search articles and Facebook posts ranked by engagement using POST /articles and POST /fbPosts

GET STARTED

Start building with NewsWhip API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use NewsWhip API for, with concrete tasks.

★ Earned-Media Campaign Tracking

Communications and PR teams use NewsWhip to track how a story performs once published — POST /articles ranked by engagement, POST /stats for total shares, and POST /syndicatedArticles to find every outlet that picked the story up. The data feeds weekly campaign reports that show reach beyond the issuing outlet, including syndicated coverage that traditional clipping services miss.

Find the top 20 most-shared English-language articles mentioning 'Project Alpha' in the last 7 days and aggregate total Facebook shares

Influencer Discovery for Facebook Campaigns

Marketing teams launching a Facebook-led campaign use POST /fbInfluencers to identify the public pages and accounts driving conversation in their topic. The endpoint returns ranked influencers with engagement metrics, so an agent can shortlist candidates for partnership outreach without manual scrolling through Facebook search.

Identify the top 10 Facebook influencers posting about sustainable fashion in the last 30 days

Regional Content Trend Monitoring

Newsroom and analyst teams pull country-scoped feeds through GET /region and GET /local to see what is trending in specific markets. Combined with POST /stats, this gives a continuously updated view of share volume and engagement velocity per region, enabling editorial decisions on which stories to translate, syndicate, or follow up.

Get the most-engaged English-language articles in Ireland for the last 24 hours from GET /region

Agent-Assisted Engagement Research

An AI agent uses NewsWhip through Jentic to answer engagement questions in natural language. The agent translates 'what was the most-shared article about the AI Act last month' into a POST /articles call with the right query and date range, summarises the response, and cites the top URLs. Jentic handles the API key injection and parameter shaping.

Answer 'what were the top 5 most-shared articles about the EU AI Act in May' using POST /articles and return the URLs with share counts

Key Endpoints

10 endpoints — newswhip provides social engagement data for news articles and facebook posts, exposing 10 endpoints across content discovery, statistics, and influencer identification.

METHOD

PATH

DESCRIPTION

POST

/articles

Search articles ranked by social engagement

POST

/fbPosts

Search Facebook posts ranked by engagement

POST

/stats

Aggregate engagement statistics for a query

POST

/fbInfluencers

Identify top Facebook influencers for a topic

GET

/region

Get trending content by country and language

GET

/publisher

Get articles by a specific publisher

POST

/articlesByHrefs

Look up engagement data for specific article URLs

POST

/articles

Search articles ranked by social engagement

POST

/fbPosts

Search Facebook posts ranked by engagement

POST

/stats

Aggregate engagement statistics for a query

POST

/fbInfluencers

Identify top Facebook influencers for a topic

GET

/region

Get trending content by country and language

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

NewsWhip API keys are stored encrypted in the Jentic vault. Jentic appends the key query parameter to each request automatically, so the agent never holds the credential in its prompt context or response history.

Intent-based discovery

Agents search Jentic for intents like 'find the most-shared articles about a topic' or 'identify Facebook influencers' and Jentic returns the matching POST /articles or POST /fbInfluencers operation with its schema, so the agent constructs a valid query body without reading docs.

Time to first call

Direct integration: half a day to wire the key query parameter, build query bodies for the POST endpoints, and parse engagement responses. Through Jentic: under 20 minutes — search, load schema, execute.

FAQs

Specific to using NewsWhip API through Jentic.

What authentication does the NewsWhip API use?

NewsWhip authenticates with an API key passed as the key query parameter on every request. Through Jentic the key is held in the encrypted vault and Jentic appends it to outgoing requests, so the raw value never appears in agent prompts or logs.

Can I find Facebook influencers by topic with the NewsWhip API?

Yes. POST /fbInfluencers accepts a query body and returns ranked Facebook pages and accounts with engagement metrics. This is the endpoint to use when an agent needs a shortlist of public influencers in a niche, rather than the per-post ranking that POST /fbPosts provides.

What is the difference between /articles and /publisher in the NewsWhip API?

POST /articles searches across all indexed publishers using a query body and ranks by engagement. GET /publisher returns articles from a single specified outlet without engagement-based ranking. Use /articles for topic-driven research and /publisher for competitive coverage analysis of a specific site.

How do I trace where an article was syndicated through Jentic?

Search Jentic for 'find syndicated copies of an article', load the POST /syndicatedArticles schema, and execute with the original URL. Jentic injects the API key automatically and the response lists every detected republication.

Does the NewsWhip API include historical engagement data?

The API surfaces engagement at the time of the call and supports look-back queries within the limits of the NewsWhip account plan. Date-range parameters on the search endpoints let an agent specify the window — historical depth and per-call result limits depend on the subscription tier.

NewsWhip API

Connect the NewsWhip API to your agent

Capabilities

Start building with NewsWhip API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs