Ahrefs Site Explorer API

Fetch data from Site Explorer reports

Operations 28

GET /site-explorer/domain-rating Domain rating #
GET /site-explorer/metrics Metrics #
GET /site-explorer/ai-responses-count AI Responses Count #
GET /site-explorer/refdomains-history Refdomains history #
GET /site-explorer/domain-rating-history Domain Rating history #
GET /site-explorer/url-rating-history URL Rating history #
GET /site-explorer/pages-history Pages history #
GET /site-explorer/metrics-history Metrics history #
GET /site-explorer/keywords-history Keywords history #
GET /site-explorer/metrics-by-country Metrics by country #
GET /site-explorer/pages-by-traffic Pages by traffic #
GET /site-explorer/refdomains Refdomains #
GET /site-explorer/anchors Anchors #
GET /site-explorer/linkeddomains Linked Domains #
GET /site-explorer/linked-anchors-external Outgoing external anchors #
GET /site-explorer/linked-anchors-internal Outgoing internal anchors #
GET /site-explorer/organic-keywords Organic keywords #
GET /site-explorer/organic-competitors Organic competitors #
GET /site-explorer/top-pages Top pages #
GET /site-explorer/paid-pages Paid pages #
GET /site-explorer/total-search-volume-history Total search volume history #
GET /site-explorer/crawled-pages Crawled pages #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/ahrefs-site-explorer-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ahrefs-site-explorer-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Ahrefs Site Explorer API
  description: Ahrefs API v3 gives programmatic access to Ahrefs' SEO, marketing, and AI-search data — backlinks, organic and paid traffic, keywords, SERPs, rank tracking, site audits, brand/AI-search visibility, web and social analytics, and account management. This is the full spec for every tool; each tool also has its own spec under /reference/.
  termsOfService: https://ahrefs.com/terms
  contact:
    name: Ahrefs
    url: https://ahrefs.com/
    email: support@ahrefs.com
  version: 3.0.0
servers:
- url: https://api.ahrefs.com/v3
  description: Ahrefs API v3
security:
- http:
  - read
tags:
- name: Site Explorer
  description: Fetch data from Site Explorer reports
paths:
  /site-explorer/domain-rating:
    get:
      tags:
      - Site Explorer
      summary: Domain rating
      operationId: site-explorer.domain-rating
      parameters:
      - description: A date to report metrics on in YYYY-MM-DD format.
        required: true
        explode: false
        schema:
          type: string
          format: date
        name: date
        in: query
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.domain-rating'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.domain-rating'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/backlinks-stats:
    get:
      tags:
      - Site Explorer
      summary: Backlinks stats
      operationId: site-explorer.backlinks-stats
      parameters:
      - description: The protocol of your target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - both
          - http
          - https
          default: both
        name: protocol
        in: query
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The scope of the search based on the target you entered.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - exact
          - prefix
          - domain
          - subdomains
          default: subdomains
        name: mode
        in: query
      - description: A date to report metrics on in YYYY-MM-DD format.
        required: true
        explode: false
        schema:
          type: string
          format: date
        name: date
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.backlinks-stats'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.backlinks-stats'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/outlinks-stats:
    get:
      tags:
      - Site Explorer
      summary: Outlinks stats
      description: '**This is a beta version of the endpoint. The data it returns may not always exactly match the corresponding values in Ahrefs UI. Data accuracy will be improved soon.**'
      operationId: site-explorer.outlinks-stats
      parameters:
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The scope of the target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - exact
          - prefix
          - domain
          - subdomains
          default: subdomains
        name: mode
        in: query
      - description: The protocol of your target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - both
          - http
          - https
          default: both
        name: protocol
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.outlinks-stats'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.outlinks-stats'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/metrics:
    get:
      tags:
      - Site Explorer
      summary: Metrics
      operationId: site-explorer.metrics
      parameters:
      - description: A date to report metrics on in YYYY-MM-DD format.
        required: true
        explode: false
        schema:
          type: string
          format: date
        name: date
        in: query
      - description: The scope of the target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - exact
          - prefix
          - domain
          - subdomains
          default: subdomains
        name: mode
        in: query
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The protocol of your target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - both
          - http
          - https
          default: both
        name: protocol
        in: query
      - description: A two-letter country code (ISO 3166-1 alpha-2).
        required: false
        explode: false
        schema:
          type: string
          enum:
          - ad
          - ae
          - af
          - ag
          - ai
          - al
          - am
          - ao
          - ar
          - as
          - at
          - au
          - aw
          - az
          - ba
          - bb
          - bd
          - be
          - bf
          - bg
          - bh
          - bi
          - bj
          - bn
          - bo
          - br
          - bs
          - bt
          - bw
          - by
          - bz
          - ca
          - cd
          - cf
          - cg
          - ch
          - ci
          - ck
          - cl
          - cm
          - cn
          - co
          - cr
          - cu
          - cv
          - cy
          - cz
          - de
          - dj
          - dk
          - dm
          - do
          - dz
          - ec
          - ee
          - eg
          - es
          - et
          - fi
          - fj
          - fm
          - fo
          - fr
          - ga
          - gb
          - gd
          - ge
          - gf
          - gg
          - gh
          - gi
          - gl
          - gm
          - gn
          - gp
          - gq
          - gr
          - gt
          - gu
          - gy
          - hk
          - hn
          - hr
          - ht
          - hu
          - id
          - ie
          - il
          - im
          - in
          - iq
          - is
          - it
          - je
          - jm
          - jo
          - jp
          - ke
          - kg
          - kh
          - ki
          - kn
          - kr
          - kw
          - ky
          - kz
          - la
          - lb
          - lc
          - li
          - lk
          - ls
          - lt
          - lu
          - lv
          - ly
          - ma
          - mc
          - md
          - me
          - mg
          - mk
          - ml
          - mm
          - mn
          - mq
          - mr
          - ms
          - mt
          - mu
          - mv
          - mw
          - mx
          - my
          - mz
          - na
          - nc
          - ne
          - ng
          - ni
          - nl
          - 'no'
          - np
          - nr
          - nu
          - nz
          - om
          - pa
          - pe
          - pf
          - pg
          - ph
          - pk
          - pl
          - pn
          - pr
          - ps
          - pt
          - py
          - qa
          - re
          - ro
          - rs
          - ru
          - rw
          - sa
          - sb
          - sc
          - se
          - sg
          - sh
          - si
          - sk
          - sl
          - sm
          - sn
          - so
          - sr
          - st
          - sv
          - td
          - tg
          - th
          - tj
          - tk
          - tl
          - tm
          - tn
          - to
          - tr
          - tt
          - tw
          - tz
          - ua
          - ug
          - us
          - uy
          - uz
          - vc
          - ve
          - vg
          - vi
          - vn
          - vu
          - ws
          - ye
          - yt
          - za
          - zm
          - zw
        name: country
        in: query
      - description: 'The search volume calculation mode: monthly or average. It affects volume, traffic, and traffic value.'
        required: false
        explode: false
        schema:
          type: string
          enum:
          - monthly
          - average
          default: monthly
        name: volume_mode
        in: query
      - description: 'The organic traffic calculation mode: static or adaptive. It affects organic traffic and traffic value.'
        required: false
        explode: false
        schema:
          type: string
          enum:
          - static
          - adaptive
          default: static
        name: traffic_mode
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.metrics'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.metrics'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/ai-responses-count:
    get:
      tags:
      - Site Explorer
      summary: AI Responses Count
      operationId: site-explorer.ai-responses-count
      parameters:
      - description: 'A comma-separated list of fields to return.


          - `chatgpt` (15 units)

          - `copilot` (15 units)

          - `gemini` (15 units)

          - `google_ai_mode` (15 units)

          - `google_ai_overviews` (15 units)

          - `google_ai_overviews_keywords` (15 units)

          - `grok` (15 units)

          - `perplexity` (15 units)'
        required: true
        explode: false
        schema:
          type: string
        name: select
        in: query
      - description: The date to report on in YYYY-MM-DD format.
        required: false
        explode: false
        schema:
          type: string
          format: date
        name: date
        in: query
      - description: The scope of the target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - exact
          - prefix
          - domain
          - subdomains
          default: subdomains
        name: mode
        in: query
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The protocol of your target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - both
          - http
          - https
          default: both
        name: protocol
        in: query
      - description: A two-letter country code (ISO 3166-1 alpha-2).
        required: false
        explode: false
        schema:
          type: string
          enum:
          - ad
          - ae
          - af
          - ag
          - ai
          - al
          - am
          - ao
          - ar
          - as
          - at
          - au
          - aw
          - az
          - ba
          - bb
          - bd
          - be
          - bf
          - bg
          - bh
          - bi
          - bj
          - bn
          - bo
          - br
          - bs
          - bt
          - bw
          - by
          - bz
          - ca
          - cd
          - cf
          - cg
          - ch
          - ci
          - ck
          - cl
          - cm
          - cn
          - co
          - cr
          - cu
          - cv
          - cy
          - cz
          - de
          - dj
          - dk
          - dm
          - do
          - dz
          - ec
          - ee
          - eg
          - es
          - et
          - fi
          - fj
          - fm
          - fo
          - fr
          - ga
          - gb
          - gd
          - ge
          - gf
          - gg
          - gh
          - gi
          - gl
          - gm
          - gn
          - gp
          - gq
          - gr
          - gt
          - gu
          - gy
          - hk
          - hn
          - hr
          - ht
          - hu
          - id
          - ie
          - il
          - im
          - in
          - iq
          - is
          - it
          - je
          - jm
          - jo
          - jp
          - ke
          - kg
          - kh
          - ki
          - kn
          - kr
          - kw
          - ky
          - kz
          - la
          - lb
          - lc
          - li
          - lk
          - ls
          - lt
          - lu
          - lv
          - ly
          - ma
          - mc
          - md
          - me
          - mg
          - mk
          - ml
          - mm
          - mn
          - mq
          - mr
          - ms
          - mt
          - mu
          - mv
          - mw
          - mx
          - my
          - mz
          - na
          - nc
          - ne
          - ng
          - ni
          - nl
          - 'no'
          - np
          - nr
          - nu
          - nz
          - om
          - pa
          - pe
          - pf
          - pg
          - ph
          - pk
          - pl
          - pn
          - pr
          - ps
          - pt
          - py
          - qa
          - re
          - ro
          - rs
          - ru
          - rw
          - sa
          - sb
          - sc
          - se
          - sg
          - sh
          - si
          - sk
          - sl
          - sm
          - sn
          - so
          - sr
          - st
          - sv
          - td
          - tg
          - th
          - tj
          - tk
          - tl
          - tm
          - tn
          - to
          - tr
          - tt
          - tw
          - tz
          - ua
          - ug
          - us
          - uy
          - uz
          - vc
          - ve
          - vg
          - vi
          - vn
          - vu
          - ws
          - ye
          - yt
          - za
          - zm
          - zw
        name: country
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.ai-responses-count'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.ai-responses-count'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/refdomains-history:
    get:
      tags:
      - Site Explorer
      summary: Refdomains history
      operationId: site-explorer.refdomains-history
      parameters:
      - description: The scope of the target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - exact
          - prefix
          - domain
          - subdomains
          default: subdomains
        name: mode
        in: query
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The protocol of your target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - both
          - http
          - https
          default: both
        name: protocol
        in: query
      - description: The start date of the historical period in YYYY-MM-DD format.
        required: true
        explode: false
        schema:
          type: string
          format: date
        name: date_from
        in: query
      - description: The end date of the historical period in YYYY-MM-DD format.
        required: false
        explode: false
        schema:
          type: string
          format: date
        name: date_to
        in: query
      - description: The time interval used to group historical data.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - daily
          - weekly
          - monthly
          default: monthly
        name: history_grouping
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.refdomains-history'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.refdomains-history'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/domain-rating-history:
    get:
      tags:
      - Site Explorer
      summary: Domain Rating history
      operationId: site-explorer.domain-rating-history
      parameters:
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The start date of the historical period in YYYY-MM-DD format.
        required: true
        explode: false
        schema:
          type: string
          format: date
        name: date_from
        in: query
      - description: The end date of the historical period in YYYY-MM-DD format.
        required: false
        explode: false
        schema:
          type: string
          format: date
        name: date_to
        in: query
      - description: The time interval used to group historical data.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - daily
          - weekly
          - monthly
          default: monthly
        name: history_grouping
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.domain-rating-history'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.domain-rating-history'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/url-rating-history:
    get:
      tags:
      - Site Explorer
      summary: URL Rating history
      operationId: site-explorer.url-rating-history
      parameters:
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The start date of the historical period in YYYY-MM-DD format.
        required: true
        explode: false
        schema:
          type: string
          format: date
        name: date_from
        in: query
      - description: The end date of the historical period in YYYY-MM-DD format.
        required: false
        explode: false
        schema:
          type: string
          format: date
        name: date_to
        in: query
      - description: The time interval used to group historical data.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - daily
          - weekly
          - monthly
          default: monthly
        name: history_grouping
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.url-rating-history'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.url-rating-history'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/pages-history:
    get:
      tags:
      - Site Explorer
      summary: Pages history
      operationId: site-explorer.pages-history
      parameters:
      - description: The scope of the target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - exact
          - prefix
          - domain
          - subdomains
          default: subdomains
        name: mode
        in: query
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The protocol of your target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - both
          - http
          - https
          default: both
        name: protocol
        in: query
      - description: A two-letter country code (ISO 3166-1 alpha-2).
        required: false
        explode: false
        schema:
          type: string
          enum:
          - ad
          - ae
          - af
          - ag
          - ai
          - al
          - am
          - ao
          - ar
          - as
          - at
          - au
          - aw
          - az
          - ba
          - bb
          - bd
          - be
          - bf
          - bg
          - bh
          - bi
          - bj
          - bn
          - bo
          - br
          - bs
          - bt
          - bw
          - by
          - bz
          - ca
          - cd
          - cf
          - cg
          - ch
          - ci
          - ck
          - cl
          - cm
          - cn
          - co
          - cr
          - cu
          - cv
          - cy
          - cz
          - de
          - dj
          - dk
          - dm
          - do
          - dz
          - ec
          - ee
          - eg
          - es
          - et
          - fi
          - fj
          - fm
          - fo
          - fr
          - ga
          - gb
          - gd
          - ge
          - gf
          - gg
          - gh
          - gi
          - gl
          - gm
          - gn
          - gp
          - gq
          - gr
          - gt
          - gu
          - gy
          - hk
          - hn
          - hr
          - ht
          - hu
          - id
          - ie
          - il
          - im
          - in
          - iq
          - is
          - it
          - je
          - jm
          - jo
          - jp
          - ke
          - kg
          - kh
          - ki
          - kn
          - kr
          - kw
          - ky
          - kz
          - la
          - lb
          - lc
          - li
          - lk
          - ls
          - lt
          - lu
          - lv
          - ly
          - ma
          - mc
          - md
          - me
          - mg
          - mk
          - ml
          - mm
          - mn
          - mq
          - mr
          - ms
          - mt
          - mu
          - mv
          - mw
          - mx
          - my
          - mz
          - na
          - nc
          - ne
          - ng
          - ni
          - nl
          - 'no'
          - np
          - nr
          - nu
          - nz
          - om
          - pa
          - pe
          - pf
          - pg
          - ph
          - pk
          - pl
          - pn
          - pr
          - ps
          - pt
          - py
          - qa
          - re
          - ro
          - rs
          - ru
          - rw
          - sa
          - sb
          - sc
          - se
          - sg
          - sh
          - si
          - sk
          - sl
          - sm
          - sn
          - so
          - sr
          - st
          - sv
          - td
          - tg
          - th
          - tj
          - tk
          - tl
          - tm
          - tn
          - to
          - tr
          - tt
          - tw
          - tz
          - ua
          - ug
          - us
          - uy
          - uz
          - vc
          - ve
          - vg
          - vi
          - vn
          - vu
          - ws
          - ye
          - yt
          - za
          - zm
          - zw
        name: country
        in: query
      - description: The start date of the historical period in YYYY-MM-DD format.
        required: true
        explode: false
        schema:
          type: string
          format: date
        name: date_from
        in: query
      - description: The end date of the historical period in YYYY-MM-DD format.
        required: false
        explode: false
        schema:
          type: string
          format: date
        name: date_to
        in: query
      - description: The time interval used to group historical data.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - daily
          - weekly
          - monthly
          default: monthly
        name: history_grouping
        in: query
      - description: Filter pages by their ranking position. `top10` returns only pages ranking in the top 10, `top100` returns all pages ranking in the top 100.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - top10
          - top100
          default: top100
        name: page_positions
        in: query
      - $ref: '#/components/parameters/site-explorer.output'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/site-explorer.pages-history'
            application/xml:
              schema:
                $ref: '#/components/schemas/site-explorer.pages-history'
        '400':
          $ref: '#/components/responses/site-explorer.error_400'
        '401':
          $ref: '#/components/responses/site-explorer.error_401'
        '403':
          $ref: '#/components/responses/site-explorer.error_403'
        '429':
          $ref: '#/components/responses/site-explorer.error_429'
        '500':
          $ref: '#/components/responses/site-explorer.error_500'
  /site-explorer/metrics-history:
    get:
      tags:
      - Site Explorer
      summary: Metrics history
      operationId: site-explorer.metrics-history
      parameters:
      - description: A comma-separated list of columns to return. See response schema for valid column identifiers.
        required: false
        explode: false
        schema:
          type: string
          default: date,org_cost,org_traffic,paid_cost,paid_traffic
        name: select
        in: query
      - description: The scope of the target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - exact
          - prefix
          - domain
          - subdomains
          default: subdomains
        name: mode
        in: query
      - description: 'The target of the search: a domain or a URL.'
        required: true
        explode: false
        schema:
          type: string
          format: url
        name: target
        in: query
      - description: The protocol of your target.
        required: false
        explode: false
        schema:
          type: string
          enum:
          - both
          - http
          - https
          default: both
        name: protocol
        in: query
      - description: A two-letter country code (ISO 3166-1 alpha-2).
        required: false
        explode: false
        schema:
          type: string
          enum:
          - ad
          - ae
          - af
          - ag
          - ai
          - al
          - am
          - ao
          - ar
          - as
          - at
          - au
          - aw
          - az
          - ba
          - bb
          - bd
          - be
          - bf
          - bg
          - bh
          - bi
          - bj
          - bn
          - bo
          - br
          - bs
          - bt
          - bw
          - by
          - bz
          - ca
          - cd
          - cf
          - cg
          - ch
          - ci
          - ck
          - cl
          - cm
          - cn
          - co
          - cr
          - cu
          - cv
          - cy
          - cz
          - de
          - dj
          - dk
          - dm
          - do
        

# --- truncated at 32 KB (376 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ahrefs/refs/heads/main/openapi/ahrefs-site-explorer-api-openapi.yml