Does the API calculate locale variance?

No. Compare country-routed collections with your own study design. The API supplies collected provider outputs; this analysis belongs in your application.

How should failed or empty collections be handled?

Inspect per-target failedRuns and each successful run identity. Empty sources or null fields are valid output; a missing failed run is not an empty successful answer. A completed job can contain failed collections.

Customer-built analysis

Google News: locale variance

Compare country-routed collections with your own study design.

Collection target: google_news. This is customer-built analysis, not a computed API response field.

Build this analysis in your application

Submit separate jobs with options.country when investigating country effects. Record prompt language and requested country alongside the results and keep other study conditions comparable.

Customer-built analysis

Country routing is a request option, not guaranteed output language or provider location. There is no language request field or returned locale-variance score. Country availability depends on deployment configuration.

The google_news target returns googleNews.results and googleNews.topNews. Article fields include title, url, snippet, publisher, position and publishedAt. Publication labels are provider text, such as 2 hours ago, not normalized timestamps. News collections can contain empty lists. Google Search and Google News share a task when requested together, while each target has its own outputs and failedRuns count.

Collected input for your analysis

These are illustrative successful run excerpts, not full result files or calculated metrics. Submit POST /v1/crawl-jobs, track completion, then download the authenticated result. Outputs depend on the target; a chatbot has no news articles or Google position fields.

{
  "runNumber": 1,
  "runTaskId": "53b39f0d-9576-44d6-a796-45dbfbfcdbf3",
  "status": "completed",
  "capturedAt": "2026-10-09T10:01:00.000Z",
  "pageUrl": "https://www.google.com/search?q=example&tbm=nws",
  "googleNews": {
    "results": [
      {
        "position": 1,
        "publishedAt": "2 hours ago",
        "publisher": "Example Publisher",
        "snippet": "Illustrative article summary.",
        "title": "Illustrative article title",
        "url": "https://example.com/article"
      }
    ],
    "topNews": []
  }
}

Illustrative provider output. Empty lists and null fields are valid; inspect failedRuns in the result file.

Full result format and failed-run handling →

Locale variance FAQ

Does the API calculate locale variance?: No. Compare country-routed collections with your own study design. The API supplies collected provider outputs; this analysis belongs in your application.
How should failed or empty collections be handled?: Inspect per-target failedRuns and each successful run identity. Empty sources or null fields are valid output; a missing failed run is not an empty successful answer. A completed job can contain failed collections.

Use collected data to build your own reporting and analysis. Our team arranges API access and follows up with next steps.

Request API access Read the docs