DatePerfect

API Endpoint

Datedata API specifications for developers.

Datedata provides a RESTful json API to query information about Dating Communities in the United States. At time of writing this documentation, DateData had 3,146 communities indexed.

Authentication

The Datedata API uses token authentication. Contact us to get your API key.

Token Authentication

GET /api/public/v1/communities/public/v1/communities/search?api_key=
Responses401
Headers
Content-Type: application/json
Body
{
  "message": "Unauthorized"
}

Token Authentication
GET/api/public/v1/communities/public/v1/communities/search{?api_key}

Each request to the API must be accompanied by a valid API Key. The API Key can be passed on the querystring as the api_key parameter or by passing the key as the x-api-key header.

URI Parameters
HideShow
api_key
string (required) 

Your API Key.


Public API

Communities

Public Communities API.This gives all details of Communities.

GET /api/public/v1/communities/public/v1/communities/search
Responses200401
Headers
Content-Type: application/json
Body
{
  "data": [
    {
      "name": "Community Name",
      "logo_url": "Community Logo URL",
      "url": "Community URL",
      "about": "Community description"
    }
  ],
  "meta": {
    "inputs": {
      "api_key": "api_key",
      "results": 10,
      "affiliate_only": 0
    },
    "hits": 418,
    "pages": 42
  }
}
Headers
Content-Type: application/json
Body
{
  "message": "Unauthorized"
}

Community search api
GET/api/public/v1/communities/public/v1/communities/search

URI Parameters
HideShow
api_key
string (required) 

Your API Key.

query
string (optional) Default: all 

Text query to be applied against communities

results
string (optional) Default: 10 

Number of search results to return

affiliate_only
string (optional) Default: false 

Only return affiliate results? true/false

connection_types
string (optional) 

Connection Type(s) to filter on. Multiple Connection Types should be comma separated, eg. dating,marriage

community_type
string (optional) 

Community Type(s) to filter on. Multiple Community Types should be comma separated, eg. matchmaking,other

sexual_orientations
string (optional) 

Sexual Orientation(s) to filter on. Multiple Sexual Orientations should be comma separated, eg. gay,straight

races
string (optional) 

Racial Orientation(s) to filter on. Multiple Racial Orientations should be comma separated, eg. asian,american

religions
string (optional) 

Religious Focus(es) to filter on. Multiple Religious Focuses should be comma separated, eg. christian,catholic

lifestyles
string (optional) 

Health & Lifestyle(s) to filter on. Multiple Health & Lifestyles should be comma separated, eg. fitness,divorced

miscellaneous
string (optional) 

Miscellaneous Affinities to filter on. Multiple Miscellaneous Affinities should be comma separated, eg. travel,wealthy

alternative_relationships
string (optional) 

Alternative Relationship(s) to filter on. Multiple Alternative Relationships should be comma separated, eg. polyamorous,swingers

platforms
string (optional) 

Platforms & Access to filter on. Multiple Platforms & Accesses should be comma separated, eg. ios,android

fetishes
string (optional) 

Fetish & Adult Affinity(s) to filter on. Multiple Fetish & Adult Affinity should be comma separated, eg. sex,BDSM. NOTE: adult flag must be set to ‘true’ or no results will be returned for this affinity

adult
string (optional) Default: false 

Return mature content? true/false


Generated by aglio on 31 Aug 2017