← Data and analysis
Collected data
Position
Per-run positions in Google search modules and news articles.
Understand the collected data
Google search results, shopping and People Also Ask use module-specific position values. Google News articles have position values within their returned lists. Chatbot sources contain title and url, without a position field.
Collected data
A position belongs to its provider module and run. Do not treat array order as an API ranking guarantee or compare different modules as one ranking. Averages such as avg_position are customer-built analysis.
Provider output examples
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": "7f5c0888-f5ad-4661-b07b-79fbbe1c7b31",
"status": "completed",
"capturedAt": "2026-10-09T10:01:00.000Z",
"pageUrl": "https://www.google.com/search?q=example",
"aioverview": null,
"serp": {
"organic": [
{
"position": 1,
"snippet": "Illustrative search result summary.",
"title": "Illustrative CRM comparison",
"url": "https://example.com/crm-comparison"
}
],
"peopleAlsoAsk": [],
"shopping": [],
"sponsored": []
}
}Position FAQ
- Does the API calculate position?
- Google search results, shopping and People Also Ask use module-specific position values. Google News articles have position values within their returned lists. Chatbot sources contain title and url, without a position field.
- 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.