> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Read a web research result > Read normalized output, delivery status, and total charges for an existing Web research request. Follow the result_url returned by every web_research action. Use `result_url` unchanged on the API origin and authenticate with a Key permitted to read every Run. The response uses the same fields as the initial Solution response. HTTP 200 can still contain `result_status: pending`; continue polling until the final Run is terminal. This is a read-only request. It creates no Runs, calls no Providers, and does not resume fallback or reset the execution budget. [Get Run](/docs/api-reference/runs/get) remains the separate API for native output and an individual Run's charge. ## OpenAPI ````yaml /openapi.json get /v1/solutions/gtm/web_research/result openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- One key, no contract, pay per call, across paid APIs bought wholesale. Every response carries x-request-id; every error body carries the same envelope. servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/solutions/gtm/web_research/result: get: tags: - Solutions summary: Read a web research result description: >- Follow result_url from search or scrape to read normalized output, business result_status and the total charge of the same Runs. HTTP 200 may still contain result_status=pending. This authenticated read creates no Runs, calls no Providers and does not resume fallback or reset budgets. GET /v1/runs/:id remains the native individual Run. The result context is signed, bound to the Workspace and checked against the current Key policy for every Run. operationId: gtm-web-research-result parameters: - name: token in: query schema: type: string minLength: 1 maxLength: 16384 description: >- Opaque result context returned in result_url. Keep it unchanged and authenticate with a Key permitted to read every listed Run. required: true responses: '200': description: WebResearchResult content: application/json: schema: $ref: '#/components/schemas/WebResearchResult' '400': description: ValidationFailed content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenEncoded' '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/NotFoundEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' security: - bearer: [] components: schemas: WebResearchResult: type: object properties: id: type: string run_url: type: string description: Open this Run in the console. Requires Workspace membership. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED or RUNNING: still in progress. COMPLETED: a Provider response is available, including non-2xx responses. FAILED: read failure. STOPPED: stopped before dispatch. Read charge_usd separately from status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Why the Run failed. Non-null only when status is FAILED. input: type: object output: anyOf: - anyOf: - type: object properties: url: type: string description: >- The requested URL, or the final URL when the Provider reports one. final_url: anyOf: - type: string - type: 'null' description: >- The post-redirect URL as reported by the Provider (Firecrawl, Exa). Null when the Provider does not report one. title: anyOf: - type: string - type: 'null' text: anyOf: - type: string - type: 'null' markdown: anyOf: - type: string - type: 'null' html: anyOf: - type: string - type: 'null' raw_html: anyOf: - type: string - type: 'null' text_character_limit: anyOf: - type: integer - type: 'null' description: >- The character cap Glasser asked the Provider to apply to text (10000 for Exa), so text of exactly this length may be truncated. Null when no cap was applied. cached: anyOf: - type: boolean - type: 'null' description: >- Whether the Provider served the page from its cache (Firecrawl cacheState, Exa status source). Null when the Provider does not say. fetched_at: anyOf: - type: string - type: 'null' description: >- When the Provider fetched the page, ISO 8601 UTC (DataForSEO fetch_time). Null when the Provider does not report it. quality: type: string enum: - unverified description: >- Deprecated: always 'unverified'; no content check is applied. Kept for compatibility and will be removed in the next breaking revision. required: - url - final_url - title - text - markdown - html - raw_html - text_character_limit - cached - fetched_at - quality additionalProperties: false - type: object properties: results: type: array items: type: object properties: url: type: string title: anyOf: - type: string - type: 'null' snippet: anyOf: - type: string - type: 'null' description: >- Google's short excerpt (Serper / SerpApi), or Exa's extracted highlight for Exa. Not the full page text. position: type: integer date: anyOf: - type: string - type: 'null' description: >- Deprecated: use published_at or date_text. Holds Google's display text for Serper / SerpApi and Exa's raw publishedDate for Exa. published_at: anyOf: - type: string - type: 'null' description: >- ISO 8601 UTC timestamp, filled only when the Provider reports a machine timestamp (Exa publishedDate, SerpApi news iso_date); otherwise null. date_text: anyOf: - type: string - type: 'null' description: >- Google's display text exactly as the Provider returned it (Serper / SerpApi date). It may be relative to the Run's completed_at, such as '3 hours ago', and is never parsed. required: - url - title - snippet - position - date - published_at - date_text additionalProperties: false required: - results additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' source: anyOf: - type: string - type: 'null' description: Publisher or site name as the Provider shows it. published_at: anyOf: - type: string - type: 'null' description: >- ISO 8601 UTC timestamp, filled only when the Provider reports a machine timestamp (Exa publishedDate, SerpApi news iso_date); otherwise null. date_text: anyOf: - type: string - type: 'null' description: >- Google's display text exactly as the Provider returned it (Serper / SerpApi date). It may be relative to the Run's completed_at, such as '3 hours ago', and is never parsed. snippet: anyOf: - type: string - type: 'null' required: - title - url - source - published_at - date_text - snippet additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: name: anyOf: - type: string - type: 'null' address: anyOf: - type: string - type: 'null' description: >- The Provider's address text, not parsed or completed. Serper may return only the street line. category: anyOf: - type: string - type: 'null' rating: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: Google's average star rating, 1–5. reviews: anyOf: - type: integer - type: 'null' description: Number of Google reviews behind the rating. phone: anyOf: - type: string - type: 'null' website: anyOf: - type: string - type: 'null' latitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' longitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' google_cid: anyOf: - type: string - type: 'null' description: >- Google Maps CID of the place (Serper cid, SerpApi data_cid). required: - name - address - category - rating - reviews - phone - website - latitude - longitude - google_cid additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' snippet: anyOf: - type: string - type: 'null' publication: anyOf: - type: string - type: 'null' year: anyOf: - type: integer - type: 'null' cited_by: anyOf: - type: integer - type: 'null' pdf_url: anyOf: - type: string - type: 'null' required: - title - url - snippet - publication - year - cited_by - pdf_url additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' description: The Google Shopping product page. merchant_url: anyOf: - type: string - type: 'null' description: >- The merchant's offer URL when the Provider reports one (SerpApi link); null for Serper. google_product_id: anyOf: - type: string - type: 'null' description: >- Google Shopping catalog product id (Serper productId, SerpApi product_id). price_text: anyOf: - type: string - type: 'null' description: >- The Provider's display price, such as '$69.00'. Not parsed; the currency follows country. seller: anyOf: - type: string - type: 'null' rating: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: Google's average star rating, 1–5. reviews: anyOf: - type: integer - type: 'null' description: Number of Google reviews behind the rating. image_url: anyOf: - type: string - type: 'null' required: - title - url - merchant_url - google_product_id - price_text - seller - rating - reviews - image_url additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' image_url: anyOf: - type: string - type: 'null' thumbnail_url: anyOf: - type: string - type: 'null' source_url: anyOf: - type: string - type: 'null' source: anyOf: - type: string - type: 'null' description: Publisher or site name as the Provider shows it. width: anyOf: - type: integer - type: 'null' height: anyOf: - type: integer - type: 'null' required: - title - image_url - thumbnail_url - source_url - source - width - height additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' channel: anyOf: - type: string - type: 'null' source: anyOf: - type: string - type: 'null' description: >- Video platform as the Provider shows it, such as YouTube. date_text: anyOf: - type: string - type: 'null' description: >- Google's display text exactly as the Provider returned it (Serper / SerpApi date). It may be relative to the Run's completed_at, such as '3 hours ago', and is never parsed. duration_text: anyOf: - type: string - type: 'null' description: Display duration as returned, such as '4:39'. snippet: anyOf: - type: string - type: 'null' thumbnail_url: anyOf: - type: string - type: 'null' required: - title - url - channel - source - date_text - duration_text - snippet - thumbnail_url additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: url: anyOf: - type: string - type: 'null' title: anyOf: - type: string - type: 'null' exa_similarity_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Exa's own similarity score for this page. Compare it only within one response; it is not comparable to other Providers' scores. published_at: anyOf: - type: string - type: 'null' description: >- ISO 8601 UTC timestamp, filled only when the Provider reports a machine timestamp (Exa publishedDate, SerpApi news iso_date); otherwise null. author: anyOf: - type: string - type: 'null' required: - url - title - exa_similarity_score - published_at - author additionalProperties: false required: - items additionalProperties: false - type: object properties: answer: anyOf: - type: string - type: 'null' citations: type: array items: type: object properties: url: anyOf: - type: string - type: 'null' title: anyOf: - type: string - type: 'null' published_at: anyOf: - type: string - type: 'null' description: >- ISO 8601 UTC timestamp, filled only when the Provider reports a machine timestamp (Exa publishedDate, SerpApi news iso_date); otherwise null. required: - url - title - published_at additionalProperties: false required: - answer - citations additionalProperties: false - type: 'null' description: >- Normalized fields per action. The Provider's native output is not repeated here; it stays on the Run (GET /v1/runs/:id). Values a Provider does not report are null. - search: results[]: url, title, snippet (Google's excerpt; Exa's extracted highlight for Exa), position, published_at, date_text, date (deprecated) - news: items[]: title, url, source, published_at, date_text, snippet - places: items[]: name, address (Provider's text; may be the street line only), category, rating (1–5), reviews, phone, website, latitude, longitude, google_cid - scholar: items[]: title, url, snippet, publication, year, cited_by, pdf_url - shopping: items[]: title, url (Google Shopping page), merchant_url, google_product_id, price_text, seller, rating (1–5), reviews, image_url - images: items[]: title, image_url, thumbnail_url, source_url, source, width, height - videos: items[]: title, url, channel, source, date_text, duration_text, snippet, thumbnail_url - answer: answer, citations[]: url, title, published_at - scrape: url, final_url, title, text, markdown, html, raw_html, text_character_limit, cached, fetched_at, quality (deprecated) - similar: items[]: url, title, exa_similarity_score, published_at, author published_at is ISO 8601 UTC and set only from a Provider's machine timestamp. date_text is Google's display text as returned; it may be relative to the Run's completed_at and is never parsed. rating is Google's 1–5 star average; reviews is a count. source is a publisher or site name. exa_similarity_score is Exa's own score and is comparable only within one response. provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- HTTP status returned by the Provider. Check this even when the Run is COMPLETED. error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: >- Non-null only when status is COMPLETED. - For 2xx responses, output contains Provider-native JSON (any shape), or null for an empty body. - For non-2xx responses, error contains the Provider's error body and output is null. Sensitive fields are removed from both bodies. charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats. - type: 'null' description: >- Total charge of runs in this Solution response. Null until all listed Runs settle. Each Run retains its own charge; failures can also be charged. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Single-Run charge basis, or null for a multi-Run total. Read runs[].charge_basis for each charge. stoppable: type: boolean description: >- Whether a stop request can currently be accepted. This does not guarantee that the Run can stop before dispatch. stop_requested_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' description: >- When a stop was requested. The Run can still continue if dispatch had already started. created_at: type: string description: ISO-8601 UTC timestamp format: date-time started_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Your stored tracking fields. Use them to filter Runs. They never go to the Provider or affect routing, Price, or idempotency. - Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters. - Values: strings of 1–500 characters. - user_id: your End user's opaque ID, never their email address or name. action: type: string enum: - search - news - places - scholar - shopping - images - videos - answer - scrape - similar result_status: type: string enum: - success - partial - no_result - error - pending description: >- Business delivery status, independent of the final Run lifecycle in status. success is not a semantic content-quality verdict. missing_formats: type: array items: type: string enum: - text - markdown - html - raw_html error: anyOf: - type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false - type: 'null' runs: type: array items: type: object properties: id: type: string run_url: type: string description: Open this Run in the console. Requires Workspace membership. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED or RUNNING: still in progress. COMPLETED: a Provider response is available, including non-2xx responses. FAILED: read failure. STOPPED: stopped before dispatch. Read charge_usd separately from status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Why the Run failed. Non-null only when status is FAILED. input: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false output: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- HTTP status returned by the Provider. Check this even when the Run is COMPLETED. required: - http_status additionalProperties: false - type: 'null' charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats. - type: 'null' description: >- Final charge as an exact USD decimal string. Null while QUEUED or RUNNING. A FAILED Run can have a non-zero charge under the Endpoint's Price. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Price clause used to calculate the charge. Null before settlement or when no Provider attempt was made. stoppable: type: boolean description: >- Whether a stop request can currently be accepted. This does not guarantee that the Run can stop before dispatch. stop_requested_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' description: >- When a stop was requested. The Run can still continue if dispatch had already started. created_at: type: string description: ISO-8601 UTC timestamp format: date-time started_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Your stored tracking fields. Use them to filter Runs. They never go to the Provider or affect routing, Price, or idempotency. - Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters. - Values: strings of 1–500 characters. - user_id: your End user's opaque ID, never their email address or name. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false result_url: type: string description: >- Authenticated, read-only URL path for polling this normalized result and total charge. Use with the API origin. Does not create Runs or resume fallback. GET /v1/runs/:id still returns the native, individual Run. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata - action - result_status - missing_formats - error - runs - result_url additionalProperties: false ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false NotFoundEncoded: type: object properties: error: type: object properties: code: type: string enum: - not_found message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.