Introduction - First Answer

Overview

The First Answer API gives you programmatic access to the data available in the First Answer platform. Use it to integrate AI visibility insights into your own workflows, dashboards, and tools. All endpoints are read-only (HTTP GET) and return data in JSON format. The API follows RESTful conventions and uses standard HTTP status codes.

Base URL

All API requests should be made to:

https://api.firstanswer.ai

Available Resources

Resource	Description
Brands	Your monitored brands and their visibility data
Groups	Prompt groups for organization
Monitored Competitors	Competitor brands and their visibility data
Monitored Prompts	AI prompts being tracked, with responses, citations, and search queries
Cited Sources	Domains and URLs cited in AI responses, with related prompts
Action Plans	Suggested action plans for improving AI visibility
Dashboard	Aggregated dashboard metrics

Response Format

All successful responses follow a consistent structure. Single resource:

{
  "data": {
    "id": 1,
    "name": "Example Brand"
  }
}

Paginated list:

{
  "pagination": {
    "current_page": 1,
    "per_page": 100,
    "total_pages": 3,
    "total_records": 250
  },
  "data": [
    { "id": 1, "name": "Example Brand" }
  ]
}

Pagination

List endpoints return paginated results. Use the page and per_page query parameters to control pagination:

Parameter	Type	Default	Description
`page`	integer	`1`	Page number (1-indexed)
`per_page`	integer	`100`	Number of items per page (min: `1`, max: `100`)

Error Format

All errors return a consistent JSON structure:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "A human-readable description of the error."
  }
}

Error Codes

HTTP Status	Code	Description
`401`	`AUTHENTICATION_FAILED`	Missing, invalid, or expired API key
`403`	`PERMISSION_DENIED`	API key does not have access to this resource
`404`	`NOT_FOUND`	The requested resource does not exist
`405`	`METHOD_NOT_ALLOWED`	HTTP method not supported for this endpoint
`429`	`RATE_LIMIT_EXCEEDED`	Project rate limit exceeded — see Rate limits
`500`	`INTERNAL_SERVER_ERROR`	An unexpected error occurred on the server

Quick Start

Get your API key

Go to your account settings and generate a new API key. Copy it immediately — it won’t be shown again.

Make your first request

curl -H "api-key: YOUR_API_KEY" \
  https://api.firstanswer.ai/v1/brands/

Explore the data

Use the response to navigate related resources like monitored prompts, citations, and competitors.

Need Help?

If you have questions or run into issues, reach out to our support team at [email protected].

​Overview

​Base URL

​Available Resources

​Response Format

​Pagination

​Error Format

​Error Codes

​Quick Start

​Need Help?