Date and Time Query Examples

Getting news in a specific date range

This query retrieves news articles published in a specific date range.

bash

curl "https://api.apitube.io/v1/news/everything?published_at.start=2026-03-01&published_at.end=2026-03-08&api_key=YOUR_API_KEY"

python

import requests

response = requests.get(
    "https://api.apitube.io/v1/news/everything",
    params={
        "published_at.start": "2026-03-01",
        "published_at.end": "2026-03-08",
        "api_key": "YOUR_API_KEY",
    },
)
print(response.json())

javascript

const params = new URLSearchParams({ "published_at.start": "2026-03-01", "published_at.end": "2026-03-08", "api_key": "YOUR_API_KEY" });
const response = await fetch(`https://api.apitube.io/v1/news/everything?${params}`);
const data = await response.json();
console.log(data);

php

$query = http_build_query(["published_at.start" => "2026-03-01", "published_at.end" => "2026-03-08", "api_key" => "YOUR_API_KEY"]);
$response = file_get_contents("https://api.apitube.io/v1/news/everything?$query");
$data = json_decode($response, true);
print_r($data);

package main

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

func main() {
	u, _ := url.Parse("https://api.apitube.io/v1/news/everything")
	q := u.Query()
	q.Set("published_at.start", "2026-03-01")
	q.Set("published_at.end", "2026-03-08")
	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/news/everything?published_at.start=2026-03-01&published_at.end=2026-03-08&api_key=YOUR_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

text

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

GET https://api.apitube.io/v1/news/everything?published_at.start=2026-03-01&published_at.end=2026-03-08

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

Using relative time ranges

This query demonstrates using different date formats to retrieve news.

bash

curl "https://api.apitube.io/v1/news/everything?published_at.start=2026-03-07&published_at.end=2026-03-08&api_key=YOUR_API_KEY"

python

import requests

response = requests.get(
    "https://api.apitube.io/v1/news/everything",
    params={
        "published_at.start": "2026-03-07",
        "published_at.end": "2026-03-08",
        "api_key": "YOUR_API_KEY",
    },
)
print(response.json())

javascript

const params = new URLSearchParams({ "published_at.start": "2026-03-07", "published_at.end": "2026-03-08", "api_key": "YOUR_API_KEY" });
const response = await fetch(`https://api.apitube.io/v1/news/everything?${params}`);
const data = await response.json();
console.log(data);

php

$query = http_build_query(["published_at.start" => "2026-03-07", "published_at.end" => "2026-03-08", "api_key" => "YOUR_API_KEY"]);
$response = file_get_contents("https://api.apitube.io/v1/news/everything?$query");
$data = json_decode($response, true);
print_r($data);

package main

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

func main() {
	u, _ := url.Parse("https://api.apitube.io/v1/news/everything")
	q := u.Query()
	q.Set("published_at.start", "2026-03-07")
	q.Set("published_at.end", "2026-03-08")
	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/news/everything?published_at.start=2026-03-07&published_at.end=2026-03-08&api_key=YOUR_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

text

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

GET https://api.apitube.io/v1/news/everything?published_at.start=2026-03-07&published_at.end=2026-03-08

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

Historical event coverage analysis

This query tracks the chronology of coverage of Donald Trump.

bash

curl "https://api.apitube.io/v1/news/everything?person.name=Donald%20Trump&category.id=medtop%3A11000000&sort.by=published_at&sort.order=asc&per_page=100&api_key=YOUR_API_KEY"

python

import requests

response = requests.get(
    "https://api.apitube.io/v1/news/everything",
    params={
        "person.name": "Donald Trump",
        "category.id": "medtop:11000000",
        "sort.by": "published_at",
        "sort.order": "asc",
        "per_page": "100",
        "api_key": "YOUR_API_KEY",
    },
)
print(response.json())

javascript

const params = new URLSearchParams({ "person.name": "Donald Trump", "category.id": "medtop:11000000", "sort.by": "published_at", "sort.order": "asc", "per_page": "100", "api_key": "YOUR_API_KEY" });
const response = await fetch(`https://api.apitube.io/v1/news/everything?${params}`);
const data = await response.json();
console.log(data);

php

$query = http_build_query(["person.name" => "Donald Trump", "category.id" => "medtop:11000000", "sort.by" => "published_at", "sort.order" => "asc", "per_page" => "100", "api_key" => "YOUR_API_KEY"]);
$response = file_get_contents("https://api.apitube.io/v1/news/everything?$query");
$data = json_decode($response, true);
print_r($data);

package main

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

func main() {
	u, _ := url.Parse("https://api.apitube.io/v1/news/everything")
	q := u.Query()
	q.Set("person.name", "Donald Trump")
	q.Set("category.id", "medtop:11000000")
	q.Set("sort.by", "published_at")
	q.Set("sort.order", "asc")
	q.Set("per_page", "100")
	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/news/everything?person.name=Donald%20Trump&category.id=medtop%3A11000000&sort.by=published_at&sort.order=asc&per_page=100&api_key=YOUR_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

text

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

GET https://api.apitube.io/v1/news/everything?person.name=Donald%20Trump&category.id=medtop%3A11000000&sort.by=published_at&sort.order=asc&per_page=100

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

Precise time analysis using timestamps

This query analyzes news about Google within a specific time window.

bash

curl "https://api.apitube.io/v1/news/everything?organization.name=Google&sort.by=published_at&sort.order=asc&per_page=10&api_key=YOUR_API_KEY"

python

import requests

response = requests.get(
    "https://api.apitube.io/v1/news/everything",
    params={
        "organization.name": "Google",
        "sort.by": "published_at",
        "sort.order": "asc",
        "per_page": "10",
        "api_key": "YOUR_API_KEY",
    },
)
print(response.json())

javascript

const params = new URLSearchParams({ "organization.name": "Google", "sort.by": "published_at", "sort.order": "asc", "per_page": "10", "api_key": "YOUR_API_KEY" });
const response = await fetch(`https://api.apitube.io/v1/news/everything?${params}`);
const data = await response.json();
console.log(data);

php

$query = http_build_query(["organization.name" => "Google", "sort.by" => "published_at", "sort.order" => "asc", "per_page" => "10", "api_key" => "YOUR_API_KEY"]);
$response = file_get_contents("https://api.apitube.io/v1/news/everything?$query");
$data = json_decode($response, true);
print_r($data);

package main

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

func main() {
	u, _ := url.Parse("https://api.apitube.io/v1/news/everything")
	q := u.Query()
	q.Set("organization.name", "Google")
	q.Set("sort.by", "published_at")
	q.Set("sort.order", "asc")
	q.Set("per_page", "10")
	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/news/everything?organization.name=Google&sort.by=published_at&sort.order=asc&per_page=10&api_key=YOUR_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

text

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

GET https://api.apitube.io/v1/news/everything?organization.name=Google&sort.by=published_at&sort.order=asc&per_page=10

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

Getting started

Endpoints

Suggest

Reference

Parameters & data

Tools & integrations

AI

Help

Examples

Recipes

Getting started

Date and Time Query Examples

Getting news in a specific date range

Using relative time ranges

Historical event coverage analysis

Precise time analysis using timestamps

Suggest

Reference

AI

Date and Time Query Examples ​

Getting news in a specific date range ​

Using relative time ranges ​

Historical event coverage analysis ​

Precise time analysis using timestamps ​

Date and Time Query Examples

Getting news in a specific date range

Using relative time ranges

Historical event coverage analysis

Precise time analysis using timestamps