Nyne.ai API Reference

Welcome to the Nyne.ai API. This API gives you programmatic access to high-intent leads and signals identified across the public web. You can use it to search, filter, and retrieve prospects based on real-time behavioral signals.

Base URL

https://api.nyne.ai/v1/

All requests must be made over HTTPS.

Authentication

Nyne.ai uses API keys to authenticate requests. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

To get your API key, log into your Nyne.ai account and go to Settings > API Access.

Rate Limits

Default: 100 requests per minute
Contact support for higher limits.

Endpoints

1. Get Leads

GET /leads

Retrieve a list of leads based on filters.

Query Parameters:

Name	Type	Description
`industry`	string	Filter by industry (e.g. “plumbing”)
`location`	string	City, state, or zip
`intent`	string	Intent signal type (e.g. “hiring”)
`limit`	int	Max number of results (default: 50)

Example Request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.nyne.ai/v1/leads?industry=marketing&location=los+angeles&intent=hiring&limit=10"

Example Response:

[
  {
    "business_name": "Creative Edge Marketing",
    "website": "https://creativeedgemarketing.com",
    "location": "Los Angeles, CA",
    "intent": "hiring",
    "signal_detected": "2025-05-25T18:30:00Z"
  },
  ...
]

2. Get Lead by ID

GET /leads/{id}

Retrieve detailed information about a single lead.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.nyne.ai/v1/leads/abc123"

3. Search Signals

POST /signals/search

Search raw intent signals directly.

Body Parameters:

{
  "query": "web design",
  "location": "texas",
  "type": "social_post"
}

Response Codes

Code	Meaning
200	Success
400	Bad Request
401	Unauthorized
404	Not Found
500	Server Error

Webhooks (Coming Soon)

You’ll soon be able to receive new intent signals via webhook in real time. Stay tuned.

Need Help?

Check out our Help Center or email us at support@nyne.ai.