> ## Documentation Index > Fetch the complete documentation index at: https://docs.peec.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Links Report > Get a report on the domains AI answers linked to in their own text. A link is a URL the answer wrote into its prose; it is never one of the sources the answer retrieved or cited, which the domains report covers. ## Prompt Scope The report covers the project's active prompts. An archived prompt is counted only when `filters` selects it with a `prompt_id` `in` predicate. ## Aggregation Formulas When aggregating results across multiple rows/dimensions: - **linked_percentage**: `sum(linked_chat_count) / sum(total_chat_count)`, only across rows that do not split the same chats (not across `url` rows of one domain). - **average_link_position** is not additive across rows. Request the coarser breakdown instead. ## OpenAPI ````yaml https://api.peec.ai/customer/v1/openapi/json post /reports/links openapi: 3.0.3 info: title: Peec AI Customer API description: Development documentation version: 1.0.0 contact: name: Peec AI Team email: support@peec.ai servers: - url: https://api.peec.ai/customer/v1 security: [] paths: /reports/links: post: tags: - Reports summary: Get Links Report description: >- Get a report on the domains AI answers linked to in their own text. A link is a URL the answer wrote into its prose; it is never one of the sources the answer retrieved or cited, which the domains report covers. ## Prompt Scope The report covers the project's active prompts. An archived prompt is counted only when `filters` selects it with a `prompt_id` `in` predicate. ## Aggregation Formulas When aggregating results across multiple rows/dimensions: - **linked_percentage**: `sum(linked_chat_count) / sum(total_chat_count)`, only across rows that do not split the same chats (not across `url` rows of one domain). - **average_link_position** is not additive across rows. Request the coarser breakdown instead. operationId: postReportsLinks parameters: - name: project_id in: query required: false schema: description: Required if using a company api key example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb type: string requestBody: required: true content: application/json: schema: type: object properties: project_id: description: Required if using a company api key example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb type: string limit: default: 1000 type: integer minimum: 1 maximum: 10000 offset: default: 0 type: integer minimum: 0 maximum: 9007199254740991 start_date: default: '2026-01-01' description: >- full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 example: '2025-09-22' type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ end_date: default: '2026-01-01' description: >- full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 example: '2025-09-22' type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ dimensions: example: - prompt_id description: >- Dimensions to break down the report by. `url` breaks each linked domain down into the pages linked. type: array items: type: string enum: - prompt_id - model_id - model_channel_id - tag_id - topic_id - date - week - month - country_code - chat_id - url filters: description: >- Row filters applied before aggregation. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `url`. Population fields (model/country/prompt/tag/topic/chat) shrink both the linked chats and `total_chat_count`; `domain` and `url` narrow the linked chats only. Multiple filters are AND'd. example: - field: model_channel_id operator: in values: - openai-0 type: array items: anyOf: - type: object properties: field: type: string enum: - model_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - chatgpt-scraper - gpt-4o - gpt-4o-search - gpt-3.5-turbo - llama-sonar - perplexity-scraper - sonar - gemini-2.5-flash - gemini-3.1-flash-lite-search - gemini-scraper - google-ai-overview-scraper - google-ai-mode-scraper - llama-3.3-70b-instruct - deepseek-r1 - deepseek-v4-pro - claude-3.5-haiku - claude-haiku-4.5 - claude-sonnet-4 - grok-scraper - microsoft-copilot-scraper - grok-4 - grok-4.3 - grok-4.6 - qwen-3-6-plus - qwen-3-7-plus - amazon-rufus-scraper - mistral-small-4 - mistral-medium-3-5 - muse-spark-1.2 - muse-spark-1.3 - naver-ai-briefing-scraper - claude-opus-5 - claude-fable-5.1 - gpt-6-astra - gpt-5.6-sol - gpt-5.6-terra - ernie-scraper required: - field - operator - values deprecated: true description: 'Deprecated: use model_channel_id filter instead' - type: object properties: field: type: string enum: - model_channel_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - openai-0 - openai-1 - qwen-0 - openai-2 - perplexity-0 - perplexity-1 - google-0 - google-1 - google-2 - google-3 - google-4 - anthropic-0 - anthropic-1 - anthropic-2 - anthropic-3 - deepseek-0 - meta-0 - meta-1 - xai-0 - xai-1 - microsoft-0 - amazon-0 - mistral-0 - mistral-1 - naver-0 - openai-3 - openai-4 - openai-5 - baidu-0 required: - field - operator - values - type: object properties: field: type: string enum: - tag_id operator: type: string enum: - in - not_in - has_all values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - topic_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - prompt_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - country_code operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - AE - AL - AM - AR - AT - AU - BA - BE - BG - BH - BO - BR - BS - BY - CA - CH - CL - CN - CO - CR - CY - CZ - DE - DK - DO - EC - EE - EG - ES - FI - FR - GB - GE - GH - GR - GT - HK - HN - HR - HU - ID - IE - IL - IN - IQ - IS - IT - JO - JP - KR - KW - LB - LI - LT - LU - LV - MA - MD - ME - MK - MN - MT - MX - MY - NG - NI - NL - 'NO' - NZ - OM - PK - PA - PE - PH - PL - PT - PY - PS - QA - RO - RS - SA - SE - SG - SI - SK - SV - TH - TN - TR - TW - UA - US - UY - VE - VN - ZA - AD - AF - AS - AZ - BB - BQ - CG - CI - CM - CW - DM - DZ - FO - GF - GP - JM - KG - KH - KI - KZ - LK - LR - LS - MW - NC - PG - TD - TF - UG - VU - ZW required: - field - operator - values - type: object properties: field: type: string enum: - chat_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - domain operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - url operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values order_by: description: >- Sort results by one or more fields. Multiple entries create a multi-key sort. Direction defaults to desc. When omitted, a default ordering is applied. example: - field: linked_chat_count direction: desc type: array items: type: object properties: field: type: string enum: - linked_chat_count - link_count - average_link_position - date - week - month direction: default: desc type: string enum: - asc - desc required: - field application/x-www-form-urlencoded: schema: type: object properties: project_id: description: Required if using a company api key example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb type: string limit: default: 1000 type: integer minimum: 1 maximum: 10000 offset: default: 0 type: integer minimum: 0 maximum: 9007199254740991 start_date: default: '2026-01-01' description: >- full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 example: '2025-09-22' type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ end_date: default: '2026-01-01' description: >- full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 example: '2025-09-22' type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ dimensions: example: - prompt_id description: >- Dimensions to break down the report by. `url` breaks each linked domain down into the pages linked. type: array items: type: string enum: - prompt_id - model_id - model_channel_id - tag_id - topic_id - date - week - month - country_code - chat_id - url filters: description: >- Row filters applied before aggregation. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `url`. Population fields (model/country/prompt/tag/topic/chat) shrink both the linked chats and `total_chat_count`; `domain` and `url` narrow the linked chats only. Multiple filters are AND'd. example: - field: model_channel_id operator: in values: - openai-0 type: array items: anyOf: - type: object properties: field: type: string enum: - model_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - chatgpt-scraper - gpt-4o - gpt-4o-search - gpt-3.5-turbo - llama-sonar - perplexity-scraper - sonar - gemini-2.5-flash - gemini-3.1-flash-lite-search - gemini-scraper - google-ai-overview-scraper - google-ai-mode-scraper - llama-3.3-70b-instruct - deepseek-r1 - deepseek-v4-pro - claude-3.5-haiku - claude-haiku-4.5 - claude-sonnet-4 - grok-scraper - microsoft-copilot-scraper - grok-4 - grok-4.3 - grok-4.6 - qwen-3-6-plus - qwen-3-7-plus - amazon-rufus-scraper - mistral-small-4 - mistral-medium-3-5 - muse-spark-1.2 - muse-spark-1.3 - naver-ai-briefing-scraper - claude-opus-5 - claude-fable-5.1 - gpt-6-astra - gpt-5.6-sol - gpt-5.6-terra - ernie-scraper required: - field - operator - values deprecated: true description: 'Deprecated: use model_channel_id filter instead' - type: object properties: field: type: string enum: - model_channel_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - openai-0 - openai-1 - qwen-0 - openai-2 - perplexity-0 - perplexity-1 - google-0 - google-1 - google-2 - google-3 - google-4 - anthropic-0 - anthropic-1 - anthropic-2 - anthropic-3 - deepseek-0 - meta-0 - meta-1 - xai-0 - xai-1 - microsoft-0 - amazon-0 - mistral-0 - mistral-1 - naver-0 - openai-3 - openai-4 - openai-5 - baidu-0 required: - field - operator - values - type: object properties: field: type: string enum: - tag_id operator: type: string enum: - in - not_in - has_all values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - topic_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - prompt_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - country_code operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - AE - AL - AM - AR - AT - AU - BA - BE - BG - BH - BO - BR - BS - BY - CA - CH - CL - CN - CO - CR - CY - CZ - DE - DK - DO - EC - EE - EG - ES - FI - FR - GB - GE - GH - GR - GT - HK - HN - HR - HU - ID - IE - IL - IN - IQ - IS - IT - JO - JP - KR - KW - LB - LI - LT - LU - LV - MA - MD - ME - MK - MN - MT - MX - MY - NG - NI - NL - 'NO' - NZ - OM - PK - PA - PE - PH - PL - PT - PY - PS - QA - RO - RS - SA - SE - SG - SI - SK - SV - TH - TN - TR - TW - UA - US - UY - VE - VN - ZA - AD - AF - AS - AZ - BB - BQ - CG - CI - CM - CW - DM - DZ - FO - GF - GP - JM - KG - KH - KI - KZ - LK - LR - LS - MW - NC - PG - TD - TF - UG - VU - ZW required: - field - operator - values - type: object properties: field: type: string enum: - chat_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - domain operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - url operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values order_by: description: >- Sort results by one or more fields. Multiple entries create a multi-key sort. Direction defaults to desc. When omitted, a default ordering is applied. example: - field: linked_chat_count direction: desc type: array items: type: object properties: field: type: string enum: - linked_chat_count - link_count - average_link_position - date - week - month direction: default: desc type: string enum: - asc - desc required: - field multipart/form-data: schema: type: object properties: project_id: description: Required if using a company api key example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb type: string limit: default: 1000 type: integer minimum: 1 maximum: 10000 offset: default: 0 type: integer minimum: 0 maximum: 9007199254740991 start_date: default: '2026-01-01' description: >- full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 example: '2025-09-22' type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ end_date: default: '2026-01-01' description: >- full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 example: '2025-09-22' type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ dimensions: example: - prompt_id description: >- Dimensions to break down the report by. `url` breaks each linked domain down into the pages linked. type: array items: type: string enum: - prompt_id - model_id - model_channel_id - tag_id - topic_id - date - week - month - country_code - chat_id - url filters: description: >- Row filters applied before aggregation. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `url`. Population fields (model/country/prompt/tag/topic/chat) shrink both the linked chats and `total_chat_count`; `domain` and `url` narrow the linked chats only. Multiple filters are AND'd. example: - field: model_channel_id operator: in values: - openai-0 type: array items: anyOf: - type: object properties: field: type: string enum: - model_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - chatgpt-scraper - gpt-4o - gpt-4o-search - gpt-3.5-turbo - llama-sonar - perplexity-scraper - sonar - gemini-2.5-flash - gemini-3.1-flash-lite-search - gemini-scraper - google-ai-overview-scraper - google-ai-mode-scraper - llama-3.3-70b-instruct - deepseek-r1 - deepseek-v4-pro - claude-3.5-haiku - claude-haiku-4.5 - claude-sonnet-4 - grok-scraper - microsoft-copilot-scraper - grok-4 - grok-4.3 - grok-4.6 - qwen-3-6-plus - qwen-3-7-plus - amazon-rufus-scraper - mistral-small-4 - mistral-medium-3-5 - muse-spark-1.2 - muse-spark-1.3 - naver-ai-briefing-scraper - claude-opus-5 - claude-fable-5.1 - gpt-6-astra - gpt-5.6-sol - gpt-5.6-terra - ernie-scraper required: - field - operator - values deprecated: true description: 'Deprecated: use model_channel_id filter instead' - type: object properties: field: type: string enum: - model_channel_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - openai-0 - openai-1 - qwen-0 - openai-2 - perplexity-0 - perplexity-1 - google-0 - google-1 - google-2 - google-3 - google-4 - anthropic-0 - anthropic-1 - anthropic-2 - anthropic-3 - deepseek-0 - meta-0 - meta-1 - xai-0 - xai-1 - microsoft-0 - amazon-0 - mistral-0 - mistral-1 - naver-0 - openai-3 - openai-4 - openai-5 - baidu-0 required: - field - operator - values - type: object properties: field: type: string enum: - tag_id operator: type: string enum: - in - not_in - has_all values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - topic_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - prompt_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - country_code operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string enum: - AE - AL - AM - AR - AT - AU - BA - BE - BG - BH - BO - BR - BS - BY - CA - CH - CL - CN - CO - CR - CY - CZ - DE - DK - DO - EC - EE - EG - ES - FI - FR - GB - GE - GH - GR - GT - HK - HN - HR - HU - ID - IE - IL - IN - IQ - IS - IT - JO - JP - KR - KW - LB - LI - LT - LU - LV - MA - MD - ME - MK - MN - MT - MX - MY - NG - NI - NL - 'NO' - NZ - OM - PK - PA - PE - PH - PL - PT - PY - PS - QA - RO - RS - SA - SE - SG - SI - SK - SV - TH - TN - TR - TW - UA - US - UY - VE - VN - ZA - AD - AF - AS - AZ - BB - BQ - CG - CI - CM - CW - DM - DZ - FO - GF - GP - JM - KG - KH - KI - KZ - LK - LR - LS - MW - NC - PG - TD - TF - UG - VU - ZW required: - field - operator - values - type: object properties: field: type: string enum: - chat_id operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - domain operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values - type: object properties: field: type: string enum: - url operator: type: string enum: - in - not_in values: minItems: 1 type: array items: type: string required: - field - operator - values order_by: description: >- Sort results by one or more fields. Multiple entries create a multi-key sort. Direction defaults to desc. When omitted, a default ordering is applied. example: - field: linked_chat_count direction: desc type: array items: type: object properties: field: type: string enum: - linked_chat_count - link_count - average_link_position - date - week - month direction: default: desc type: string enum: - asc - desc required: - field responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: type: object properties: domain: type: string example: acme.com url: description: The linked page, when the `url` dimension is set. example: https://acme.com/pricing type: string classification: type: string description: >- OWN, COMPETITOR or RELATED when the domain belongs to a tracked brand, the name of a custom domain classification, or OTHER. example: COMPETITOR prompt: type: object properties: id: type: string example: pr_93f790de-5b7a-45ee-b782-61103c81f20d required: - id model: deprecated: true description: 'Deprecated: use model_channel instead' type: object properties: id: type: string example: gpt-4o-search required: - id model_channel: type: object properties: id: type: string example: openai-1 required: - id tag: type: object properties: id: type: string example: tg_23abec5b-100a-4261-9ee7-1effe68f0149 required: - id topic: type: object properties: id: type: string example: to_e6b8cdd3-a51b-4d94-a866-28dbe6b830a6 required: - id country_code: example: US type: string chat: type: object properties: id: type: string example: ch_abc123 required: - id date: type: string week: example: '2025-03-10' description: Start (Monday) of the ISO week bucket. type: string month: example: '2025-03-01' description: First day of the month bucket. type: string linked_chat_count: type: number example: 18 description: >- Number of distinct chats whose answer linked to this domain in its own text. linked_percentage: type: number example: 0.6 description: '`linked_chat_count / total_chat_count`, from 0 to 1.' link_count: type: number example: 24 description: >- Total number of links to this domain across those chats. An answer can link to the same page more than once. average_link_position: type: number example: 1.4 description: >- Average rank of this domain's links among each answer's links, where 1 is the first link in the answer. total_chat_count: type: number example: 30 description: >- Total number of chats in scope for this row, the denominator for `linked_percentage`. Population filters shrink it; `domain` and `url` filters do not. required: - domain - classification - linked_chat_count - linked_percentage - link_count - average_link_position - total_chat_count required: - data description: Success security: - APIKeyHeader: [] - APIKeyQuery: [] - BearerAuth: [] components: securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key APIKeyQuery: type: apiKey in: query name: api_key BearerAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.