> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# getScoutingReport

`POST /v1/scouting-report`

**Tags:** `Company info`

Get company scouting report

**Endpoint:** `https://api.fiber.ai/v1/scouting-report`

## Description

Generates a comprehensive scouting report for a company including news, founders, funding, media links, and historical headcount. This endpoint may take 1-2 minutes to respond as it gathers data from multiple sources — please set a generous client timeout (at least 120 seconds).

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: 6 credits per scouting report ⓘ

## Request body (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your Fiber API key"
    },
    "company": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "identifier": {
              "type": "string",
              "enum": [
                "linkedinUrl"
              ]
            },
            "value": {
              "type": "string",
              "minLength": 1,
              "description": "LinkedIn company URL (e.g. 'https://www.linkedin.com/company/openai')."
            }
          },
          "required": [
            "identifier",
            "value"
          ]
        },
        {
          "type": "object",
          "properties": {
            "identifier": {
              "type": "string",
              "enum": [
                "linkedinSlug"
              ]
            },
            "value": {
              "type": "string",
              "minLength": 1,
              "description": "LinkedIn company slug (e.g. 'openai')."
            }
          },
          "required": [
            "identifier",
            "value"
          ]
        },
        {
          "type": "object",
          "properties": {
            "identifier": {
              "type": "string",
              "enum": [
                "linkedinOrgId"
              ]
            },
            "value": {
              "type": "string",
              "pattern": "^\\d+$",
              "minLength": 1,
              "description": "LinkedIn numeric organization ID (e.g. '11130470')."
            }
          },
          "required": [
            "identifier",
            "value"
          ]
        },
        {
          "type": "object",
          "properties": {
            "identifier": {
              "type": "string",
              "enum": [
                "domain"
              ]
            },
            "value": {
              "type": "string",
              "minLength": 1,
              "description": "Company website domain (e.g. 'openai.com')."
            }
          },
          "required": [
            "identifier",
            "value"
          ]
        }
      ],
      "description": "Company identifier. Set identifier to 'linkedinUrl', 'linkedinSlug', 'linkedinOrgId', or 'domain' and provide the corresponding value."
    }
  },
  "required": [
    "apiKey",
    "company"
  ]
}
```

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "object",
      "properties": {
        "company": {
          "type": "object",
          "properties": {
            "linkedinUrl": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "description": "LinkedIn company URL. Null when no validated LinkedIn URL could be resolved."
            },
            "linkedinOrgId": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "description": "LinkedIn numeric organization ID. Null when the company has no known org ID."
            },
            "name": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "description": "Company display name. Null when the name is not available in our data."
            },
            "domain": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "description": "Company website domain. Null when the domain is not available in our data."
            }
          },
          "required": [
            "linkedinUrl",
            "linkedinOrgId",
            "name",
            "domain"
          ]
        },
        "report": {
          "type": "object",
          "properties": {
            "news": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "description": "Article headline"
                  },
                  "url": {
                    "type": "string",
                    "description": "Article URL"
                  },
                  "date": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Publication date (ISO format) or null"
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Brief summary of the article"
                  },
                  "sentiment": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "positive",
                      "negative",
                      "neutral",
                      null
                    ],
                    "description": "Article tone toward the company. Use null if unclear."
                  }
                },
                "required": [
                  "title",
                  "url"
                ]
              },
              "default": []
            },
            "mediaLinks": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "youtube",
                      "podcast"
                    ]
                  },
                  "title": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "type",
                  "title",
                  "url"
                ]
              },
              "default": []
            },
            "blogPosts": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  },
                  "date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "title",
                  "url"
                ]
              },
              "default": []
            },
            "aboutDescription": {
              "type": [
                "string",
                "null"
              ]
            },
            "companyPhotos": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "caption": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "url"
                ]
              },
              "default": []
            },
            "milestones": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "type",
                  "description"
                ]
              },
              "default": []
            },
            "fundingInfo": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "stage": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "totalFundingUsd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "lastRoundUsd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "lastRoundDate": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "investors": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "default": []
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "investors"
              ]
            },
            "jobPosts": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "jobId": {
                    "type": "string"
                  },
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "location": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "postedAt": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "jobUrl": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "locationType": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "jobId",
                  "title",
                  "location",
                  "postedAt",
                  "jobUrl",
                  "locationType"
                ]
              },
              "default": []
            },
            "founders": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "role": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "linkedinUrl": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "profilePicUrl": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "name"
                ]
              },
              "default": []
            },
            "historicalHeadcount": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "latest_snapshot_date": {
                  "type": "string",
                  "format": "date"
                },
                "snapshots": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "date": {
                        "type": "string",
                        "format": "date"
                      },
                      "employees": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "date",
                      "employees"
                    ]
                  }
                },
                "growth": {
                  "type": "object",
                  "properties": {
                    "1m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    },
                    "2m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    },
                    "3m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    },
                    "6m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    },
                    "12m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    },
                    "18m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    },
                    "24m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    },
                    "36m": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "percent": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "percent",
                        "quantity"
                      ]
                    }
                  }
                }
              },
              "required": [
                "latest_snapshot_date",
                "snapshots",
                "growth"
              ],
              "default": null
            },
            "companySummary": {
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "companyProfile": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "headline": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "logoUrl": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "website": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "linkedinUrl": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "followerCount": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "employeeCount": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "foundedYear": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "streetAddress": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "locality": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "countryName": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "stateCode": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "industries": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "string"
                  }
                },
                "specialties": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "string"
                  }
                },
                "twitterHandle": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "facebookUrl": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "wellfoundSlug": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "name",
                "headline",
                "description",
                "logoUrl",
                "website",
                "linkedinUrl",
                "followerCount",
                "employeeCount",
                "foundedYear",
                "streetAddress",
                "locality",
                "countryName",
                "stateCode",
                "industries",
                "specialties",
                "twitterHandle",
                "facebookUrl",
                "wellfoundSlug"
              ],
              "default": null
            },
            "officeLocations": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "is_primary": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "location": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "properties": {
                      "street_address": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "neighborhood": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "city": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "state_name": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "state_code": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "county": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "postal_code": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "country_code": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "country_name": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "coordinates": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "properties": {
                          "lat": {
                            "type": "number"
                          },
                          "lon": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "lat",
                          "lon"
                        ]
                      },
                      "timezone": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "full_address": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "formatted_address": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    }
                  }
                }
              },
              "default": [],
              "description": "Company office locations with structured address details and coordinates. Empty when no office data is available."
            }
          },
          "required": [
            "news",
            "mediaLinks",
            "blogPosts",
            "companyPhotos",
            "milestones",
            "jobPosts",
            "founders",
            "historicalHeadcount",
            "companySummary",
            "companyProfile",
            "officeLocations"
          ],
          "description": "The generated scouting report"
        }
      },
      "required": [
        "company",
        "report"
      ]
    },
    "chargeInfo": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-now"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged"
          ],
          "description": "Credits were charged immediately for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charging-later"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "Credits will be charged after the operation completes"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-for-async-process"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged",
            "message"
          ],
          "description": "Credits that were charged for an asynchronous operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "free"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "No credits were charged for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "credits-refunded"
              ]
            },
            "creditsRefunded": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsRefunded",
            "message"
          ],
          "description": "Credits were refunded for this operation"
        }
      ]
    },
    "warnings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')"
          },
          "message": {
            "type": "string",
            "description": "Warning message"
          }
        },
        "required": [
          "field",
          "message"
        ]
      },
      "description": "Warnings about extraneous fields in request"
    },
    "advice": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo"
  ],
  "additionalProperties": false
}
```

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)