Skip to main content

​
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

ResourceDescription
BrandsYour monitored brands and their visibility data
GroupsPrompt groups for organization
Monitored CompetitorsCompetitor brands and their visibility data
Monitored PromptsAI prompts being tracked, with responses, citations, and search queries
Cited SourcesDomains and URLs cited in AI responses, with related prompts
Action PlansSuggested action plans for improving AI visibility
DashboardAggregated 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:
ParameterTypeDefaultDescription
pageinteger1Page number (1-indexed)
per_pageinteger100Number 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 StatusCodeDescription
401AUTHENTICATION_FAILEDMissing, invalid, or expired API key
403PERMISSION_DENIEDAPI key does not have access to this resource
404NOT_FOUNDThe requested resource does not exist
405METHOD_NOT_ALLOWEDHTTP method not supported for this endpoint
429RATE_LIMIT_EXCEEDEDProject rate limit exceeded — see Rate limits
500INTERNAL_SERVER_ERRORAn unexpected error occurred on the server

​
Quick Start

1

Get your API key

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

Make your first request

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

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].