One monitoring record, optionally including its answer
curl --request GET \
--url https://app.geoly.ai/api/v1/records/{record_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.geoly.ai/api/v1/records/{record_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.geoly.ai/api/v1/records/{record_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"id": "<string>",
"platform_code": "<string>",
"platform_name": "<string>",
"record_date_at": "2023-11-07T05:31:56Z",
"business_date": "<string>",
"status": "pending",
"position": 123,
"mention_rank": 123,
"mentions": 1,
"sentiment": "positive",
"sentiment_polarity": 0,
"prompt_id": "<string>",
"prompt_text": "<string>",
"in_flight": true,
"executed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"ai_model": "<string>",
"country": "<string>",
"sentiment_highlights": [
"<string>"
],
"displayed": {
"sentiment": "positive",
"mention_rank": 123
},
"web_search_status": "searched",
"search_queries": [
"<string>"
],
"related_prompts": [
"<string>"
],
"shopping_visible": true,
"ai_overview_triggered": true,
"answer_text": "<string>",
"answer_text_state": "included",
"citations": [
{
"id": "<string>",
"source_type": "citation",
"url": "<string>",
"site_name": "<string>",
"domain": "<string>",
"title": "<string>",
"position": 123,
"cited": true,
"description": "<string>",
"link_text": "<string>",
"marker_positions": [
123
],
"is_brand_mention": true
}
],
"total_citations": 1,
"citations_truncated": true,
"search_sources": [
{
"id": "<string>",
"rank": 123,
"url": "<string>",
"title": "<string>",
"snippet": "<string>",
"published": "<string>"
}
],
"total_search_sources": 1,
"search_sources_truncated": true,
"shopping": [
{
"id": "<string>",
"title": "<string>",
"rating": 123,
"reviews": 1,
"link": "<string>",
"image_url": "<string>",
"seller": "<string>",
"final_price": 123,
"price_currency": "<string>",
"tag": "<string>"
}
],
"total_shopping": 1,
"shopping_truncated": true,
"mentioned_brands": [
{
"entity_id": "<string>",
"source": "entity",
"name": "<string>",
"is_own_brand": true,
"role": "<string>",
"stance": "preferred",
"stance_source": "vote",
"mention_count": 1,
"domain": "<string>"
}
],
"mentioned_brands_state": "ok"
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"schema_conformant": true,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}监测记录
获取单条监测记录
Answer text is only returned when include=answer_text. Citations, search sources and shopping are bounded (30/30/20), with total counts and truncation flags. Internal provider errors and raw analysis are excluded. Responses exceeding 4 MB are rejected before settlement; omit include to fetch metadata. Billed per call at the price in x-geoly-cost, using the existing MCP credit meter. Billing outcomes are in meta.quota.
GET
/
api
/
v1
/
records
/
{record_id}
One monitoring record, optionally including its answer
curl --request GET \
--url https://app.geoly.ai/api/v1/records/{record_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.geoly.ai/api/v1/records/{record_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.geoly.ai/api/v1/records/{record_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"id": "<string>",
"platform_code": "<string>",
"platform_name": "<string>",
"record_date_at": "2023-11-07T05:31:56Z",
"business_date": "<string>",
"status": "pending",
"position": 123,
"mention_rank": 123,
"mentions": 1,
"sentiment": "positive",
"sentiment_polarity": 0,
"prompt_id": "<string>",
"prompt_text": "<string>",
"in_flight": true,
"executed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"ai_model": "<string>",
"country": "<string>",
"sentiment_highlights": [
"<string>"
],
"displayed": {
"sentiment": "positive",
"mention_rank": 123
},
"web_search_status": "searched",
"search_queries": [
"<string>"
],
"related_prompts": [
"<string>"
],
"shopping_visible": true,
"ai_overview_triggered": true,
"answer_text": "<string>",
"answer_text_state": "included",
"citations": [
{
"id": "<string>",
"source_type": "citation",
"url": "<string>",
"site_name": "<string>",
"domain": "<string>",
"title": "<string>",
"position": 123,
"cited": true,
"description": "<string>",
"link_text": "<string>",
"marker_positions": [
123
],
"is_brand_mention": true
}
],
"total_citations": 1,
"citations_truncated": true,
"search_sources": [
{
"id": "<string>",
"rank": 123,
"url": "<string>",
"title": "<string>",
"snippet": "<string>",
"published": "<string>"
}
],
"total_search_sources": 1,
"search_sources_truncated": true,
"shopping": [
{
"id": "<string>",
"title": "<string>",
"rating": 123,
"reviews": 1,
"link": "<string>",
"image_url": "<string>",
"seller": "<string>",
"final_price": 123,
"price_currency": "<string>",
"tag": "<string>"
}
],
"total_shopping": 1,
"shopping_truncated": true,
"mentioned_brands": [
{
"entity_id": "<string>",
"source": "entity",
"name": "<string>",
"is_own_brand": true,
"role": "<string>",
"stance": "preferred",
"stance_source": "vote",
"mention_count": 1,
"domain": "<string>"
}
],
"mentioned_brands_state": "ok"
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"schema_conformant": true,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}{
"error": {
"code": "INVALID_BODY",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "<string>",
"report": "<string>",
"duration_ms": 123,
"quota": {
"cost": 123,
"unlimited": true,
"remaining": 123,
"resets_at": "2023-11-07T05:31:56Z",
"charge": "charged",
"min_fee_reason": "missing_locale"
}
}
}授权
API key from Settings → Developer → API keys (prefix geom_). Each key is bound to one brand.
路径参数
Resource id for this API key brand.
Required string length:
1 - 64查询参数
Return the full answer text; otherwise answer_text is null.
可用选项:
answer_text 响应
One monitoring record, optionally including its answer. data follows Record when meta.schema_conformant is true.