> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tamradar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Industry Radar

> Create an industry radar for keyword-level tracking.



## OpenAPI

````yaml /api_specs.yaml POST /v1/radars/industry
openapi: 3.0.0
info:
  title: TAMradar API
  version: '1.0'
  description: Canonical OpenAPI spec for TAMradar customer-facing APIs.
servers:
  - url: https://api.tamradar.com
    description: Production API server
security: []
paths:
  /v1/radars/industry:
    post:
      tags:
        - Radars
      summary: Create an industry radar
      description: >-
        Creates an industry radar for global monitoring. Four types available:
        'industry_mentions' tracks keyword mentions across all domains,
        'industry_funding_rounds' monitors all global funding rounds,
        'industry_new_companies' tracks newly launched startups and
        entrepreneurs coming out of stealth mode, and 'industry_job_openings'
        monitors job postings by keyword and location filters. Unlike
        company/contact radars, industry radars are not restricted to specific
        domains.
      operationId: createIndustryRadar
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - radar_type
              properties:
                radar_type:
                  type: string
                  description: The type of industry activity to track
                  enum:
                    - industry_mentions
                    - industry_funding_rounds
                    - industry_new_companies
                    - industry_job_openings
                webhook_url:
                  type: string
                  format: uri
                  description: >-
                    Webhook URL to receive radar updates and notifications.
                    Optional — if omitted, the radar is poll-only and updates
                    are available via GET /v1/updates.
                  example: https://webhook.site/your-webhook-id
                keyword:
                  type: string
                  minLength: 3
                  description: >-
                    Required for 'industry_mentions' and
                    'industry_job_openings'. The keyword or phrase to track
                    across all domains or in job postings. Must be at least 3
                    characters long. Not used for 'industry_funding_rounds' or
                    'industry_new_companies'.
                  example: artificial intelligence
                countries:
                  type: array
                  items:
                    type: string
                  maxItems: 5
                  description: >-
                    Optional for 'industry_job_openings' only. Array of country
                    names to filter job postings by location. Maximum 5
                    countries allowed. Examples: 'United States', 'Canada',
                    'United Kingdom'.
                  example:
                    - United States
                    - Canada
                custom_fields:
                  type: object
                  description: >-
                    Optional metadata to attach to this radar. Values must be
                    strings only. Use for internal tracking like account_id,
                    customer_id, or campaign_id. Returned with every webhook.
                  additionalProperties: true
                  example:
                    account_id: acc_123
                    market_research: ai-trends-2024
                    priority: high
            examples:
              industry_mentions:
                summary: Track keyword mentions
                value:
                  radar_type: industry_mentions
                  webhook_url: https://webhook.site/your-webhook-id
                  keyword: artificial intelligence
                  custom_fields:
                    account_id: acc_123
                    market_research: ai-trends-2024
              industry_funding_rounds:
                summary: Monitor global funding rounds
                value:
                  radar_type: industry_funding_rounds
                  webhook_url: https://webhook.site/your-webhook-id
                  custom_fields:
                    account_id: acc_123
                    region: global
              industry_new_companies:
                summary: Track newly launched startups
                value:
                  radar_type: industry_new_companies
                  webhook_url: https://webhook.site/your-webhook-id
                  custom_fields:
                    account_id: acc_123
                    focus: b2b-saas
              industry_job_openings:
                summary: Monitor job postings with keyword and location filters
                value:
                  radar_type: industry_job_openings
                  webhook_url: https://webhook.site/your-webhook-id
                  keyword: growth marketing
                  countries:
                    - United States
                    - Canada
                  custom_fields:
                    campaign_id: q4-2024-hiring
                    priority: high
      responses:
        '201':
          description: Radar created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  code:
                    type: integer
                    enum:
                      - 201
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      radar_id:
                        type: string
                        format: uuid
                      radar_type:
                        type: string
                      domain:
                        type: string
                        description: >-
                          Always null for industry radars as they track across
                          all domains
                        nullable: true
                        example: null
                      webhook_url:
                        type: string
                        format: uri
                      radar_status:
                        type: string
                        enum:
                          - active
                        default: active
                      created_at:
                        type: string
                        format: date-time
                      deactivated_at:
                        type: string
                        format: date-time
                        nullable: true
                      next_charge_at:
                        type: string
                        format: date-time
                        nullable: true
                      custom_fields:
                        type: object
                      keyword:
                        type: string
                        description: >-
                          The keyword being tracked (only present for
                          industry_mentions)
                        nullable: true
                  timestamp:
                    type: string
                    format: date-time
              examples:
                industry_mentions_response:
                  summary: Industry mentions radar created
                  value:
                    status: success
                    code: 201
                    timestamp: '2024-03-20T10:15:30.000Z'
                    message: Radar created successfully
                    data:
                      radar_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                      radar_type: industry_mentions
                      domain: null
                      webhook_url: https://webhook.site/your-webhook-id
                      radar_status: active
                      created_at: '2024-03-20T10:15:30.000Z'
                      deactivated_at: null
                      next_charge_at: '2024-04-20T10:15:30.000Z'
                      custom_fields:
                        account_id: acc_123
                        market_research: ai-trends-2024
                      keyword: artificial intelligence
                industry_funding_rounds_response:
                  summary: Industry funding rounds radar created
                  value:
                    status: success
                    code: 201
                    timestamp: '2024-03-20T10:15:30.000Z'
                    message: Radar created successfully
                    data:
                      radar_id: b2c3d4e5-f6a7-8901-bcde-f23456789012
                      radar_type: industry_funding_rounds
                      domain: null
                      webhook_url: https://webhook.site/your-webhook-id
                      radar_status: active
                      created_at: '2024-03-20T10:15:30.000Z'
                      deactivated_at: null
                      next_charge_at: '2024-04-20T10:15:30.000Z'
                      custom_fields:
                        account_id: acc_123
                        region: global
                industry_new_companies_response:
                  summary: Industry new companies radar created
                  value:
                    status: success
                    code: 201
                    timestamp: '2024-03-20T10:15:30.000Z'
                    message: Radar created successfully
                    data:
                      radar_id: c3d4e5f6-a7b8-9012-cdef-345678901234
                      radar_type: industry_new_companies
                      domain: null
                      webhook_url: https://webhook.site/your-webhook-id
                      radar_status: active
                      created_at: '2024-03-20T10:15:30.000Z'
                      deactivated_at: null
                      next_charge_at: '2024-04-20T10:15:30.000Z'
                      custom_fields:
                        account_id: acc_123
                        focus: b2b-saas
        '400':
          description: Invalid request data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missing_keyword:
                  summary: Missing keyword for industry_mentions
                  value:
                    status: error
                    code: 400
                    message: Invalid request body
                    errors:
                      - field: keyword
                        reason: Keyword is required for industry_mentions radar type
                    timestamp: '2026-04-23T17:05:26.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
                invalid_keyword:
                  summary: Keyword too short
                  value:
                    status: error
                    code: 400
                    message: Invalid request body
                    errors:
                      - field: keyword
                        reason: Keyword must be at least 3 characters
                    timestamp: '2026-04-23T17:05:26.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
                invalid_radar_type:
                  summary: Invalid radar type
                  value:
                    status: error
                    code: 400
                    message: Invalid request body
                    errors:
                      - field: radar_type
                        reason: >-
                          Invalid radar type. Must be 'industry_mentions' or
                          'industry_funding_rounds'
                    timestamp: '2026-04-23T17:05:26.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
        '401':
          description: Authentication required - Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missing_api_key:
                  summary: Missing API key
                  value:
                    status: error
                    code: 401
                    message: Missing API key
                    errors:
                      - field: x-api-key
                        reason: API key is required
                    timestamp: '2024-03-20T10:15:30.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
                invalid_api_key:
                  summary: Invalid API key format
                  value:
                    status: error
                    code: 401
                    message: Invalid API key format
                    errors:
                      - field: x-api-key
                        reason: Invalid API key format
                    timestamp: '2024-03-20T10:15:30.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
        '402':
          description: Payment Required - Insufficient balance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                insufficient_balance:
                  summary: Insufficient balance
                  value:
                    status: error
                    code: 402
                    message: Insufficient balance
                    errors:
                      - field: balance
                        reason: You do not have enough balance to create this radar.
                    timestamp: '2024-03-20T10:15:30.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
        '403':
          description: Forbidden - Valid API key but insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                insufficient_permissions:
                  summary: Insufficient permissions
                  value:
                    status: error
                    code: 403
                    message: Insufficient permissions
                    errors:
                      - field: permission
                        reason: Your API key does not have permission to create radars
                    timestamp: '2024-03-20T10:15:30.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
        '409':
          description: Conflict - radar already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                keyword_exists:
                  summary: Keyword already being tracked
                  value:
                    status: error
                    code: 409
                    message: 'Conflict: Radar already exists'
                    errors:
                      - field: keyword
                        reason: >-
                          An industry mentions radar for this configuration
                          (keyword "artificial intelligence") already exists.
                          Conflicting radar_id:
                          7e3dda58-a046-4746-8247-258b6fd9c3ac. You can view it
                          using GET /v1/radars/{radar_id}
                    timestamp: '2024-03-20T10:15:30.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
                funding_rounds_exists:
                  summary: Industry funding rounds radar already exists
                  value:
                    status: error
                    code: 409
                    message: 'Conflict: Radar already exists'
                    errors:
                      - field: radar_type
                        reason: >-
                          An industry funding rounds radar already exists for
                          your account. Conflicting radar_id:
                          8f4eeb69-b157-5857-9358-369c7ae0f4bd. You can view it
                          using GET /v1/radars/{radar_id}
                    timestamp: '2024-03-20T10:15:30.000Z'
                    error_id: c83fd4e4-5cdb-45f5-a25b-41ba81f4f5ce
        '429':
          description: >-
            Rate limit exceeded — no operation was performed. Check
            `Retry-After` to know when to retry, or `X-RateLimit-Remaining` to
            know your current budget.
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds until your budget is restored
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Your per-minute budget for this endpoint
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Tokens remaining right now
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                minute_limit:
                  summary: Per-minute budget exhausted
                  value:
                    status: error
                    code: 429
                    message: Per-minute rate limit exceeded. Retry after 45 seconds.
                    errors:
                      - field: rate_limit
                        reason: minute
                    timestamp: '2026-04-23T17:05:26.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
                burst_limit:
                  summary: Per-second burst limit hit
                  value:
                    status: error
                    code: 429
                    message: Per-second burst limit exceeded. Retry after 1 second.
                    errors:
                      - field: rate_limit
                        reason: burst
                    timestamp: '2026-04-23T17:05:26.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                server_error:
                  summary: Internal server error
                  value:
                    status: error
                    code: 500
                    message: An internal server error occurred.
                    errors: []
                    timestamp: '2024-03-20T10:15:30.000Z'
                    error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - status
        - code
        - message
        - errors
        - timestamp
        - error_id
      properties:
        status:
          type: string
          enum:
            - error
        code:
          type: integer
          enum:
            - 400
            - 401
            - 402
            - 403
            - 404
            - 409
            - 429
            - 500
            - 503
        message:
          type: string
        errors:
          type: array
          items:
            type: object
            required:
              - field
              - reason
            properties:
              field:
                type: string
              reason:
                type: string
        timestamp:
          type: string
          format: date-time
        error_id:
          type: string
          format: uuid
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````