Recorded URLs

Recorded URLs are pages associated with a project that Topify can use for URL-driven prompt discovery. Recording a URL does not create a prompt by itself; use the prompt recommendation endpoint when you want new prompt candidates.

List recorded URLs

GET /projects/{project_id}/recording

curl "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/recording" \
  -H "X-API-Key: tk_live_..."

Response

{
  "code": 200,
  "message": "200 OK",
  "data": {
    "project_id": "a1b2c3d4-...",
    "total": 1,
    "urls": [
      {
        "id": "e5f6a7b8-...",
        "url": "https://acme.com/pricing",
        "normalized_url": "https://acme.com/pricing",
        "title": "Pricing | Acme",
        "icon_urls": ["https://www.google.com/s2/favicons?domain=acme.com&sz=128"],
        "created_at": "2026-07-13T12:00:00+00:00"
      }
    ]
  }
}

Add recorded URLs

POST /projects/{project_id}/recording

Adds up to 50 URLs in one request. If title is omitted, Topify fetches it in the background.

Request body

Field	Type	Required	Description
`urls`	object[]	Yes	One to 50 URL objects
`urls[].url`	string	Yes	Page URL
`urls[].title`	string	No	Page title; fetched asynchronously when omitted

curl -X POST "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/recording" \
  -H "X-API-Key: tk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"urls":[{"url":"https://acme.com/pricing","title":"Pricing | Acme"}]}'

Response

{
  "code": 200,
  "message": "200 OK",
  "data": {
    "project_id": "a1b2c3d4-...",
    "affected_count": 1,
    "total_recorded": 4
  }
}

Remove recorded URLs

DELETE /projects/{project_id}/recording

Removes URLs from the recording list. It does not delete prompts or prompt analytics.

Send only the URLs you intend to remove. API keys currently have full-team access.

curl -X DELETE "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/recording" \
  -H "X-API-Key: tk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://acme.com/pricing"]}'

The response uses the same affected_count and total_recorded fields as the add endpoint.

Getting started

Authorized AI agent setup

Endpoints

List recorded URLs

Response

Add recorded URLs

Request body

Response

Remove recorded URLs

​List recorded URLs

​Response

​Add recorded URLs

​Request body

​Response

​Remove recorded URLs

List recorded URLs

Response

Add recorded URLs

Request body

Response

Remove recorded URLs