Meta AI API

GET   /api/v1/search?engine=meta_ai

Send a question to the meta_ai engine to receive a structured answer. Text answers include Markdown and text blocks. Additional result collections depend on the source answer.

To continue an answer, pass pagination.conversation_token with the next question. Keep the same country and omit lat and lon for follow-up requests. Use lat and lon together when starting a location-based conversation. Answers use the country’s default time zone or the nearest time zone to the supplied coordinates, and retain it on follow-ups.

Local answers can include a map_image URL showing the places on a map.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The question to send to Meta AI, up to 15000 characters. The limit counts UTF-16 code units; a supplementary character such as an emoji counts as two.

Localization

  • Name
    country
    Required
    Optional
    Description

    The country for the answer. The default parameter is us. Keep the same country when continuing a conversation. Supported values: us, gb, de, uk, ar, bd, br, ca, eg, es, fr, id, in, it, kr, mx, ng, ph, pk, pl, th, tr, vn.

Geographic Location

  • Name
    lat
    Required
    Optional
    Description

    The latitude for a new conversation. Supply lat and lon together and omit them on follow-ups. Valid range: -90 to 90.

  • Name
    lon
    Required
    Optional
    Description

    The longitude for a new conversation. Supply lat and lon together and omit them on follow-ups. Valid range: -180 to 180.

Conversation

  • Name
    conversation_token
    Required
    Optional
    Description

    Use pagination.conversation_token from a fresh response to continue the conversation. Up to 4096 characters.

Engine

  • Name
    engine
    Required
    Required
    Description

    Set to meta_ai.

API key

  • Name
    api_key
    Required
    Required
    Description

    Your SearchAPI API key. You can also use the Authorization: Bearer header.

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set to true to disable persistent storage and request logging.

Response

Response
GET
https://www.searchapi.io/api/v1/search?engine=meta_ai&q=who+is+Taylor+Swift
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "meta_ai",
  "q": "who is Taylor Swift"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_WrewD1O8geEZuWPmgRQ6lvxX",
    "status": "Success",
    "created_at": "2026-11-05T17:10:02Z",
    "request_time_taken": 13.51,
    "parsing_time_taken": 0.0,
    "total_time_taken": 13.51,
    "request_url": "https://www.meta.ai/?q=who+is+Taylor+Swift",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_WrewD1O8geEZuWPmgRQ6lvxX.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_WrewD1O8geEZuWPmgRQ6lvxX"
  },
  "search_parameters": {
    "engine": "meta_ai",
    "q": "who is Taylor Swift",
    "country": "us"
  },
  "text_blocks": [
    {
      "type": "paragraph",
      "answer": "Taylor Swift is an American singer-songwriter — one of the best-selling and most influential artists of the 21st century."
    },
    ...
  ],
  "markdown": "Taylor Swift is an American singer-songwriter — one of the best-selling and most influential artists of the 21st century.\n\n**Basics:**\n- **Full name:** Taylor Alison Swift, born December 13, 1989 in West Reading, Pennsylvania\n- **Occupation:** Singer-songwriter, also listed as record producer, actre...",
  "reference_links": [
    {
      "index": 0,
      "title": "Taylor Swift - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Taylor_swift",
      "source": "en.wikipedia.org",
      "favicon": "https://www.google.com/s2/favicons?domain=en.wikipedia.org&sz=128"
    },
    ...
  ],
  "web_results": [
    {
      "position": 1,
      "title": "Taylor Swift - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Taylor_swift",
      "source": "en.wikipedia.org",
      "favicon": "https://www.google.com/s2/favicons?domain=en.wikipedia.org&sz=128"
    },
    ...
  ],
  "cards": [
    {
      "type": "knowledge_entity",
      "name": "Taylor Swift",
      "category": "ig_profile",
      "id": "taylorswift",
      "details": {
        "link": "https://www.instagram.com/taylorswift",
        "username": "taylorswift",
        "avatar": "https://scontent.cdninstagram.com/v/t51.82787-19/811102599_18700319776054956_6854910356429154091_n.j...",
        "is_verified": true
      }
    },
    ...
  ],
  "search_queries": [
    "who is Taylor Swift biography"
  ],
  "thinking_steps": [
    {
      "title": "Searching Taylor Swift biography"
    }
  ],
  "response_metadata": {
    "message_id": "13992e7b-2eb9-46b8-a1ad-07236bb95d07",
    "title": "About Taylor Swift",
    "is_web_search_performed": true
  },
  "pagination": {
    "conversation_token": "TEU5clA1NHk4NGZhUWZLZG9YaUZtNktKYVkwdXlxcTcvRnZxNXUxbWY1ZUc5Yy9yWENneGdGak13Zkx5YTlRSWhWOEZsYnhqcVlTbGJZbnRja245djlBNGtTVk9ScWF1T0k1cGVFVEY2RW5KUmlaN1FxTGgxVktuWWdFSzR2Tkhlc3lRek1qUFFnZGxNK3JVbFdmak53WTNtTzN3RWFOS041QWpTWmh6SmNTSnUxZUhmKytoVkVWU2c2SDBHYVB4cHVKQ1E2REF2QzV6emlGZkthQkQxY2xWUlczU1dNYlBCZUg3bDdGblQrR0tlUDRCNWg4dExLU3RJbWNYaG1YSUJDSnZzUVdUa2RJbVlOeUdrWkMyRWp2cldtV2tDOWN6TS9KQmVMK0V1ZTAxSXhoWG5JbFNJYWFISDBva2E4UlJMUmZqdnZ6WnI2MlR0d0dGekl6NHRzRGZsakEvVkVaZk5WS1NYYUFzdWdRMmRaZnBsU3NDY1lTb1BVemZnREZmc0lFbGVKc2FBWERXYlh2RisyT2JPOGxncDcvYXZjbFBtTE0wN1NjK2l0cDd4M3pOOHIybXBPVHlDVlBDSUJ1eXd0b2xGVWNWb3g0dmlNYW9MTnRrZ3RGZVJCV2drMkg1dWdabGRWSFlCcWdDMGh1Tm1xdTFnUnQva0lpOWlEN2JMSGxSOTRBWXIyUGVVdmtTdFpBYVVGZVVJVG4zdHJFc3N0WTVPdWdORmFkMFVDWkFzWHNlRWNoNmNZU1FpUnJ0V1NrWjdoV2l3YmxTUUhrYnVsdzl6MEVnSmQxcFk5SnlOcStNNmpZZjY4MXFLYTM3a2VWeDRWcVZTVmt5N1h1U0tnRkQxR0FxTE5aMmFld0ZUSGxqSE55dGFHUW1sTHAvcTVsSml2Qmk3alErQ21sZ0JRbThXaVJYQkR6L1ZKRWQxOGRIWjhjc29PM0tnS0d0aUJtTUZuWmVCdjJKajlhTTNwQS80MUJlT2x1czBZWnBBZktDNUd3MEtOeXdJQT09LS1iUUthVVg3TTliUk1iM2JXLS1YTVRvRnR6eXpvZW44WnZRWlVPb2tnPT0"
  }
}