Freshness overview
The freshness layer is separate from scrape and research. It tracks whether a known source should be re-fetched.
Core routes:
POST /v1/freshness/sourcesPOST /v1/freshness/sources/bulkPOST /v1/freshness/sources/:id/fetchedGET /v1/freshness/entities/:entity_idGET /v1/freshness/dashboardGET /v1/freshness/dueDELETE /v1/freshness/sources/:id
Inspect one entity freshness state
```bash
curl https://api.faircompany.ai/v1/freshness/entities/company_stripe \
-H "Authorization: Bearer fc_live_xxx"
```
```ts
const dashboard = await fc.freshness.entitySources("company_stripe");
console.log(dashboard.summary);
console.log(dashboard.sources[0]?.freshnessState);
```
```python
status = fc.freshness_check("company_stripe")
print(status.summary)
print(status.sources[0].freshness_state if status.sources else None)
```
```json
{
"tool": "faircrawl_freshness_check",
"arguments": {
"entity_id": "company_stripe"
}
}
```