Journalists

The Journalists endpoints provide a searchable directory of journalists (article bylines), normalized by name — bylines appearing across multiple outlets are merged into a single record with an outlets array. Profiles include a coverage block (activity, topics, who they cover) and the journalist's latest articles.

Normalization caveat

Journalists are merged by exact name. This means distinct people sharing a name, and generic bylines (e.g. admin, Redaktion), may be merged into one record. Stronger disambiguation is planned for a future release.

Added in 1.0.42

Full response field definitions are in API Response Structure. See also the Find journalists on a beat recipe.

Endpoints

GET /v1/journalists          # list & search
GET /v1/journalists/{id}     # single journalist profile

Authentication via the X-API-Key header or the api_key query parameter.

List & search

GET /v1/journalists

Query Parameters

Parameter	Type	Required	Description
name	string	No	Filter by journalist name (substring match).
page	integer	No	Page number (default 1).
per_page	integer	No	Results per page (default 100, max 250).
api_key	string	Yes*	Your API key. Can also be provided via headers.

* Required if not provided in headers

Example

cURL

curl "https://api.apitube.io/v1/journalists?name=Alex&per_page=5&api_key=YOUR_API_KEY"

Python

import requests

resp = requests.get(
    "https://api.apitube.io/v1/journalists",
    params={"name": "Alex", "per_page": 5, "api_key": "YOUR_API_KEY"},
)
print(resp.json())

Node.js

const params = new URLSearchParams({ name: "Alex", per_page: "5", api_key: "YOUR_API_KEY" });
const resp = await fetch(`https://api.apitube.io/v1/journalists?${params}`);
console.log(await resp.json());

PHP

$query = http_build_query(["name" => "Alex", "per_page" => 5, "api_key" => "YOUR_API_KEY"]);
$data = json_decode(file_get_contents("https://api.apitube.io/v1/journalists?$query"), true);
print_r($data);

Go

package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	u, _ := url.Parse("https://api.apitube.io/v1/journalists")
	q := u.Query()
	q.Set("name", "Alex")
	q.Set("per_page", "5")
	q.Set("api_key", "YOUR_API_KEY")
	u.RawQuery = q.Encode()

	resp, _ := http.Get(u.String())
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var data map[string]any
	json.Unmarshal(body, &data)
	fmt.Println(data)
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.apitube.io/v1/journalists?name=Alex&per_page=5&api_key=YOUR_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

AI Prompt

Write a script in your preferred language that calls the APITube News API:

GET https://api.apitube.io/v1/journalists?name=Alex&per_page=5

Read the API key from an environment variable (do not hardcode it), handle request
errors, and print the key fields of each result.
Docs: https://docs.apitube.io/platform/news-api/parameters

{
  "status": "ok",
  "limit": 5,
  "page": 1,
  "has_next_pages": true,
  "results": [
    {
      "id": 1431,
      "name": "Alex Weiner",
      "outlets": [
        { "id": 1277, "name": "arizonasports.com", "domain": "arizonasports.com" }
      ],
      "outlet_count": 1,
      "links": {
        "self": "https://api.apitube.io/v1/journalists/1431",
        "articles": "https://api.apitube.io/v1/news/everything?author.id=1431"
      }
    }
  ]
}

Journalist profile

GET /v1/journalists/{id}

Returns a journalist with all outlets they publish under (merged by name), a coverage block, and recent_articles.

Query Parameters

Parameter	Type	Required	Description
coverage	string	No	Set to false to omit the coverage block.
api_key	string	Yes*	Your API key.

{
  "id": 1431,
  "name": "Alex Weiner",
  "outlets": [ { "id": 1277, "name": "arizonasports.com", "domain": "arizonasports.com" } ],
  "links": { "self": "...", "articles": "..." },
  "coverage": {
    "article_count": 10,
    "first_seen": "2026-02-03",
    "last_seen": "2026-03-06",
    "sentiment": { "positive": 0, "neutral": 0, "negative": 1 },
    "momentum": { "last_30_days": 4, "previous_30_days": 6, "change_pct": -33 },
    "timeline": [ { "period": "2026-02-01", "count": 8 } ],
    "top_topics": [ { "id": "sports", "name": "Sports", "count": 6 } ],
    "top_entities": [ { "id": 1480590, "name": "University of Arizona", "count": 9 } ],
    "top_countries": [ { "id": 102, "name": "United States", "code": "us", "count": 10 } ],
    "top_languages": [ { "id": 1, "name": "English", "code": "en", "count": 10 } ]
  },
  "recent_articles": [ { "id": "...", "title": "...", "href": "...", "published_at": "..." } ]
}

Coverage fields

Field	Description
article_count	Total articles authored.
first_seen / last_seen	Date range of activity.
sentiment	Article counts by overall polarity.
momentum	Articles in the last 30 days vs. the previous 30 days.
timeline	Monthly article counts.
top_topics	Topics the journalist writes about most.
top_entities	Entities (people, companies, places) the journalist covers most.
top_countries / top_languages	Geographic and language spread of their articles.
recent_articles	The journalist's latest articles.

Pricing

Each request costs 1 point, charged only when the response contains at least one result. Zero-result searches are free. Requests with no remaining credits return 402.

Errors

A request for a non-existent journalist returns 404 with code ER0151 (Journalist not found.).