/sources

GET /sources

Endpoint

curl -X GET "https://api.newsdatahub.com/v1/sources" \
  -H "X-Api-Key: your_api_key_here" \
  -H "User-Agent: docs-sources/1.0-curl"

Retrieve comprehensive metadata about news sources including geographic location, publication type, political leaning, reliability scores, and content focus areas. Use this endpoint to discover sources, build source directories, filter by characteristics, or enrich your applications with source intelligence. Requires a paid plan. Not available on the free tier.

Access Requirements

This endpoint requires a paid plan. Free tier users do not have access to the /sources endpoint. Access to source metadata helps you discover publications, build source directories, and enrich your applications with detailed source intelligence.

Query Parameters

Filter and search sources using these parameters:

Parameter	Type	Description
q	string	Search query to find sources by name or description
country	string	ISO 3166-1 alpha-2 country code to filter sources by country. See available countries
language	string	ISO 639-1 language code to filter sources by primary language. See available languages
region	string	Filter by geographic region: north_america, south_america, europe, asia, africa, oceania, middle_east
type	string	Filter by source type: digital_native, press_release, newspaper, magazine, mainstream_news, blog, specialty_news, news_agency
coverage	string	Filter by coverage area (comma-separated): national, local, international, regional
per_page	integer	Results per page (max 100, default 20)
cursor	string	Pagination cursor from previous response

Response Format

{
  "next_cursor": "MTc0MTA5NDI4MDAwMCw5NTI1OTMwNQ==",
  "total_results": 1245,
  "per_page": 20,
  "data": [
    {
      "id": "source_id",
      "title": "Source Name",
      "description": "Standardized English description",
      "country": "MX",
      "language": "es",
      "region": "north_america",
      "type": "newspaper",
      "coverage": ["national", "local"],
      "website": "https://example.com",
      "base_url": "https://example.com",
      "geolocation": {
        "latitude": 19.4326,
        "longitude": -99.1332,
        "city": "Mexico City",
        "timezone": "America/Mexico_City"
      },
      "founded_year": 1990,
      "enhanced_metadata": {
        "reliability_score": 7,
        "bias_rating": {
          "political_leaning": "center_left",
          "objectivity_score": 6
        },
        "content_focus": [
          "politics",
          "technology",
          "economics"
        ]
      }
    }
  ]
}

Response Attributes

Root Level

• next_cursor (string or null) — Pagination cursor for the next page of results
• total_results (number) — Total count of available sources
• per_page (number) — Number of sources returned per page
• data (array) — Array of source objects

Source Object

• id (string) — Unique identifier for the source
• title (string) — Name of the source
• description (string) — Standardized English description of the source
• country (string) — Country code (ISO 3166-1 alpha-2)
• language (string) — Primary language of the source
• region (string) — Geographic region (north_america, south_america, europe, asia, africa, oceania, middle_east)
• type (string) — Type of the source (see Source Types section for details)
• coverage (array) — Coverage areas (national, local, international, regional)
• website (string) — Full website URL
• base_url (string) — Base URL of the source

Geolocation

• latitude (number or null) — Latitude coordinate (null for sources where HQ location couldn’t be determined)
• longitude (number or null) — Longitude coordinate (null for sources where HQ location couldn’t be determined)
• city (string or null) — City name (null for sources where HQ location couldn’t be determined)
• timezone (string or null) — IANA timezone identifier (e.g., ‘America/New_York’) (null for sources where timezone couldn’t be determined)

Note

For some sources, particularly blogs and smaller publications, we may not have complete information about their headquarters location. In these cases, the geolocation fields (latitude, longitude, city, timezone) may be null.

Enhanced Metadata

• founded_year (number or null) — Year the source was founded (null if unknown)
• reliability_score (number) — Score from 0-10 indicating the source’s estimated reliability based on factors like factual reporting history, use of credible sources, transparency about ownership/funding, and adherence to journalistic standards.
• bias_rating.political_leaning (string) — Categorization of the source’s editorial stance (far_left, left, center_left, center, center_right, right, far_right, nonpartisan).
• bias_rating.objectivity_score (number) — Score from 0-10 indicating the source’s estimated objectivity based on separation of news from opinion, use of neutral language, presentation of multiple perspectives, and factual reporting regardless of political stance.
• content_focus (array) — An array of the main subjects typically covered by the source.

Important Note

reliability_score, political_leaning, objectivity_score, and content_focus were generated using AI-based analysis of available information about the sources. While efforts were made to ensure accuracy and fairness in these assessments, they should be interpreted as estimates rather than definitive classifications. The evaluation criteria were designed to be as objective as possible, but inherent limitations exist in any automated assessment.

Source Types

• digital_native — News organizations that originated online and primarily publish digitally
• press_release — Official announcements issued by organizations
• newspaper — Traditional print news publications, including their online versions
• magazine — Periodical publications covering specific subjects or interests
• mainstream_news — Major news outlets with broad audience reach
• blog — Regularly updated websites typically run by individuals or small groups
• specialty_news — Publications focused on specific industries, topics, or niches
• news_agency — Wire services and news agencies that distribute content to other outlets