Get one AI traffic site - Reputably

Get one AI traffic site

curl --request GET \
  --url https://app.reputably.net/api/entities/AiTrafficSite/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.reputably.net/api/entities/AiTrafficSite/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.reputably.net/api/entities/AiTrafficSite/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.reputably.net/api/entities/AiTrafficSite/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.reputably.net/api/entities/AiTrafficSite/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "location_id": "<string>",
  "domain": "<string>",
  "site_key": "<string>",
  "install_type": "worker",
  "first_seen_at": "<string>",
  "last_seen_at": "<string>",
  "verify_nonce": "<string>",
  "verified_at": "<string>"
}

GET

/

api

/

entities

/

AiTrafficSite

/

{id}

Get one AI traffic site

curl --request GET \
  --url https://app.reputably.net/api/entities/AiTrafficSite/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.reputably.net/api/entities/AiTrafficSite/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.reputably.net/api/entities/AiTrafficSite/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.reputably.net/api/entities/AiTrafficSite/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.reputably.net/api/entities/AiTrafficSite/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "location_id": "<string>",
  "domain": "<string>",
  "site_key": "<string>",
  "install_type": "worker",
  "first_seen_at": "<string>",
  "last_seen_at": "<string>",
  "verify_nonce": "<string>",
  "verified_at": "<string>"
}

Authorizations

Authorization

string

header

required

An agent key (rpk_...) created in Settings → API & MCP, sent as Authorization: Bearer rpk_.... Bearer only: a cookie session can never drive this API. An OAuth 2.1 access token obtained from the same host works identically and lands on the same ceiling.

Headers

X-Workspace-Id

string

Which workspace to read. Omit it and you get the account’s home workspace, which on an agency account is often not where the live businesses are. A workspace this credential cannot read is refused with 403 rather than quietly answered from the default.

Path Parameters

id

string

required

The AI traffic site id.

Response

The AI traffic site.

id

string

Unique id.

location_id

string

domain

string

Bare lowercase hostname, www stripped. Normalized on write — BusinessLocation.website is stored raw and cannot be compared directly.

site_key

string

Public identifier embedded in the installed tracker ('rst_' + 32 hex). Not a secret in any meaningful sense — it ships in client-side code on the beacon path — so it grants append-only ingest for exactly one site and nothing else.

install_type

enum<string>

Which tracker reported last. 'beacon' can only ever see AI referrals; crawler hits require worker/server because AI crawlers do not execute JavaScript.

Available options:

worker,

server,

beacon

first_seen_at

string

last_seen_at

string

Last accepted ingest. Drives the 'installed / silent' badge on the setup card.

verify_nonce

string

Set by verifyAiTrafficSite: we fetch the site with this nonce in the query string and wait for the installed tracker to report it back, which proves the whole pipe end to end.

verified_at

string