> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiforgeo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Task results

> The answer, entity, source, fan-out, product and ad schemas.

A completed task has a `result`. Read it with [`GET /v1/tasks/{taskId}`](https://docs.apiforgeo.com/api-reference/get-a-task), or take it from the `task.completed` webhook.

> [!WARNING]
>
> A result is readable for 7 days after completion, until `resultExpiresAt`. After that, `result` is `null`. The task itself, with its cost and metadata, stays. Save what you need within the 7 days.

## Example

```json theme={null}
{
  "id": "task_0193f2a7b8c77d1e9f3a4b5c6d7e8f90",
  "status": "completed",
  "model": "chatgpt",
  "country": "US",
  "language": "en",
  "completedAt": "2026-11-19T10:00:14.000Z",
  "resultExpiresAt": "2026-11-26T10:00:14.000Z",
  "result": {
    "answer": "Here is what stands out for \"best running shoes for flat feet\":\n\n1. **Brooks Adrenaline GTS 24**: the most recommended stability shoe...",
    "entities": [
      { "name": "Brooks", "type": "brand", "position": 1, "mentions": 3, "sentiment": 0.8, "stance": "chosen" },
      { "name": "ASICS", "type": "brand", "position": 2, "mentions": 2, "sentiment": 0.6, "stance": "described" },
      { "name": "Hoka", "type": "brand", "position": 3, "mentions": 2, "sentiment": 0.1, "stance": "described" },
      { "name": "Reddit", "type": "company", "position": 4, "mentions": 1, "sentiment": 0, "stance": "named" }
    ],
    "sources": [
      {
        "url": "https://www.runnersworld.com/gear/a20865766/best-stability-running-shoes/",
        "domain": "runnersworld.com",
        "title": "The Best Stability Running Shoes",
        "position": 1
      }
    ],
    "fanOuts": [
      { "phrase": "best running shoes for flat feet 2026" },
      { "phrase": "stability running shoes overpronation reviews" }
    ],
    "products": [
      {
        "name": "Brooks Adrenaline GTS 24",
        "brand": "Brooks",
        "price": { "amountMicros": 139950000, "currency": "USD" },
        "rating": 4.7,
        "reviewCount": 2381,
        "imageUrl": null,
        "position": 1,
        "merchants": [
          {
            "name": "Zappos",
            "url": "https://www.zappos.com/p/brooks-adrenaline-gts-24",
            "price": { "amountMicros": 129950000, "currency": "USD" }
          }
        ]
      }
    ],
    "ads": [
      {
        "position": 1,
        "format": "product",
        "advertiser": "Brooks Running",
        "brand": "Brooks",
        "title": "Brooks Adrenaline GTS 24",
        "body": "Support that feels smooth, mile after mile.",
        "imageUrl": null,
        "url": "https://www.brooksrunning.com/en_us/adrenaline-gts-24",
        "price": { "amountMicros": 139950000, "currency": "USD" },
        "strikethroughPrice": { "amountMicros": 159950000, "currency": "USD" },
        "rating": 4.7
      }
    ]
  }
}
```

An empty list means the answer had none: many answers show no products and no ads.

## answer

The model's answer as it gave it, in markdown.

## entities

The brands, companies and other entities the answer names.

| Field | Type | Meaning |
| - | - | - |
| `name` | string | The entity, for example `Brooks`. |
| `type` | string | The kind of entity, for example `brand` or `company`. |
| `position` | integer or null | Its rank in the answer: `1` is named first. |
| `mentions` | integer | How many times the answer names it. |
| `sentiment` | number or null | From `-1` (negative) to `+1` (positive). Null when not scored. |
| `stance` | string or null | How the answer treats it. Null when not judged. See below. |

| `stance` | The answer... |
| - | - |
| `chosen` | recommends it. |
| `described` | explains it, without a recommendation. |
| `named` | only names it. |
| `dismissed` | sets it aside. |
| `criticized` | speaks against it. |

## sources

The pages the model cited.

| Field | Type | Meaning |
| - | - | - |
| `url` | string or null | The page. |
| `domain` | string | Its domain, for example `reddit.com`. |
| `title` | string or null | The page title, when known. |
| `position` | integer or null | Its rank in the answer's citations. |

## fanOuts

The web searches the model ran while it answered, in its order. Each has a `phrase`, for example `best running shoes for flat feet 2026`. Use them to see which queries you must rank for.

## products

The product cards shown with the answer.

| Field | Type | Meaning |
| - | - | - |
| `name` | string | The product. |
| `brand` | string or null | Its brand. |
| `price` | Money or null | The price shown. |
| `rating` | number or null | The star rating. |
| `reviewCount` | integer or null | The number of reviews. |
| `imageUrl` | string or null | The product image. |
| `position` | integer | Its rank among the products. |
| `merchants` | array | Each merchant's `name`, `url` and `price`. |

## ads

The sponsored cards shown with the answer.

| Field | Type | Meaning |
| - | - | - |
| `position` | integer | Its rank among the ads. |
| `format` | string or null | The ad format, as the engine names it. |
| `advertiser` | string or null | Who paid for the ad. |
| `brand` | string or null | The brand it shows. |
| `title`, `body` | string or null | Its text. |
| `imageUrl`, `url` | string or null | Its image and its link. |
| `price` | Money or null | The price shown. |
| `strikethroughPrice` | Money or null | The crossed-out price beside it, when the ad shows one. |
| `rating` | number or null | The star rating. |

## Money

A price is `{ "amountMicros": 139950000, "currency": "USD" }`: an integer in millionths of the currency unit, and an ISO 4217 code. `139950000` is \$139.95. Divide by 1,000,000 to show it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.