Track Perplexity answers

Get structured output from Perplexity AI on your brand, your products or any other topic, in many regions

post/v1/monitor/perplexity

Request

  • Base URL: https://api.answerline.dev
  • URL: https://api.answerline.dev/v1/monitor/perplexity
  • Auth: HTTP bearer

Request body

promptstring required

Prompt submitted to Perplexity

countrystring required

Code of the country or region used to localize the response

statestring

State code for targeting below the country level (e.g., "CA"; "DC" included). Allowed only when country is "US". Served for Gemini; on a model that cannot place a state yet, a request that includes it is rejected as a validation error and is not charged.

Example request

{
  "prompt": "Which laptop should I buy for software development?",
  "country": "US",
  "include": {
    "html": true,
    "markdown": true,
    "rawResponse": true
  },
  "state": "CA"
}

Response

Perplexity monitoring result (success)

successboolean required

Example response

{
  "success": true,
  "result": {
    "text": "According to recent sources, these are the strongest monitors for coding...",
    "html": "https://files.answerline.dev/html/c45a5081-808d-4ed3-9c86-e4baf16c8ab8/1/page-1.html",
    "sources": [
      {
        "position": 1,
        "url": "https://techcrunch.com/laptops",
        "label": "TechCrunch",
        "description": "Recent tablet reviews and buying advice"
      },
      {
        "position": 2,
        "url": "https://www.youtube.com/watch?v=example",
        "label": "Top Notebooks This Year",
        "description": "Hands-on test of coding laptops"
      },
      {
        "position": 3,
        "url": "https://wired.com/programming-laptops",
        "label": "Wired",
        "description": "Guide to picking a laptop for coding"
      }
    ],
    "citationPills": [
      {
        "label": "Top Developer Monitors 2026 — Wired",
        "citationPillId": 1,
        "url": "https://techcrunch.com/laptops",
        "domain": "techcrunch.com",
        "description": "Recent tablet reviews and buying advice",
        "position": 1
      },
      {
        "label": "Tom's Hardware Laptop Buying Guide",
        "citationPillId": 1,
        "url": "https://wired.com/programming-laptops",
        "domain": "wired.com",
        "description": "Guide to picking a laptop for coding",
        "position": 3
      }
    ],
    "markdown": "According to recent sources, these are the strongest monitors for coding...",
    "related_queries": [
      "safest areas to book accommodation in Lisbon",
      "best-reviewed boutique hotels in Lisbon below €250",
      "best-reviewed seafood tascas in Alfama"
    ],
    "videos": [
      {
        "title": "Lisbon's top hotels, ranked | The Guardian",
        "url": "https://www.independent.co.uk/travel/europe/portugal/lisbon/best-lisbon-portugal-hotels-b1987832.html",
        "thumbnail": "https://d2u1z1lopyfwlx.cloudfront.net/thumbnails/636fbd12-6dee-5f44-a76d-fe7f9cd20e40/75ce41cb-6767-5082-a330-ee97c5866886.jpg",
        "medium": "image",
        "source": "web",
        "image_width": 5600,
        "image_height": 3733,
        "thumbnail_width": 300,
        "thumbnail_height": 200
      }
    ],
    "images": [
      {
        "title": "Lisbon's top hotels, ranked | The Guardian",
        "url": "https://www.independent.co.uk/travel/europe/portugal/lisbon/best-lisbon-portugal-hotels-b1987832.html",
        "thumbnail": "https://d2u1z1lopyfwlx.cloudfront.net/thumbnails/636fbd12-6dee-5f44-a76d-fe7f9cd20e40/75ce41cb-6767-5082-a330-ee97c5866886.jpg",
        "medium": "image",
        "source": "web",
        "image_width": 5600,
        "image_height": 3733,
        "thumbnail_width": 300,
        "thumbnail_height": 200
      }
    ],
    "hotels": [
      {
        "name": "Casa do Largo Porto Boutique Hotel",
        "url": "https://www.tripadvisor.com/Hotel_Review-g189158-d12659702-Reviews-Corpo_Santo_Lisbon_Historical_Hotel-Lisbon_District_Central_Portugal.html",
        "rating": 4.9,
        "num_reviews": 4374,
        "address": [
          "Rua das Flores, 41, Porto 4050-265 Portugal"
        ],
        "phone": "+351 21 340 5600",
        "description": "Set just steps from the old harbour, in one of the most sought-after quarters of central Porto...",
        "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/30/28/6c/86/caption.jpg",
        "lat": 38.707397,
        "lng": -9.142318,
        "categories": [
          "Hotel"
        ]
      }
    ],
    "places": [
      {
        "name": "Jardim do Miradouro",
        "url": "https://www.tripadvisor.com/Restaurant_Review-g189158-d1520116-Reviews-Floresta_Das_Escadinhas-Lisbon_District_Central_Portugal.html",
        "rating": 4.8,
        "address": [
          "Carrer de Mallorca 401, Barcelona 08013 Spain"
        ],
        "lat": 38.712717,
        "lng": -9.136362,
        "categories": [
          "Healthy",
          "Grill",
          "Barbecue",
          "Mediterranean",
          "Portuguese",
          "European"
        ],
        "map_url": "https://google.com/maps/?q=find+best+hotels+and+restaurants+in+lisbon&ll=38.720914,-9.147162&z=15"
      }
    ],
    "shopping_cards": [
      {
        "tags": [
          "running",
          "athletic"
        ],
        "products": [
          {
            "title": "Brooks Ghost 16",
            "id": "nike-pegasus-41",
            "url": "https://www.nike.com/t/pegasus-41",
            "price": "$140.00",
            "merchant": "Nike",
            "available": true,
            "numReviews": 1284,
            "offers": [
              {
                "price": "$140.00",
                "merchant_name": "Nike",
                "product_name": "Brooks Ghost 16 Running Shoes",
                "available": true,
                "price_details": {
                  "display_price": "$140.00"
                }
              }
            ],
            "position": 1,
            "rating": 4.6,
            "description": "Lightweight support for long-distance road racing."
          }
        ]
      }
    ],
    "search_model_queries": [
      "top places to eat and stay in lisbon"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.